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A letter from the Editors 


According to a popular gift Web site, the Hot Topics Newsletter has now reached 
its "diamond jewelry" anniversary!! (Actually, because the Newsletter comes out 
twice a year, our tenth issue marks our fifth anniversary, but hopefully you'll let 
it slide just this once.) In the style of so many rap artists these days, we'll each 
accept a nameplate necklace that spells out "Hot Topics Editor" in diamond- 
encrusted letters. ‘Thank you very much. 

After five years and ten successful issues, we're allowing ourselves the 
indulgence of looking back at all the things that have changed since we started. 
Five years isn't really a long time in the grand scheme of things, but it seems like 
an eternity in the computer age. Way back in August of 1999, when we published 
our first issue, z/OS didn't even exist yet! Issue | was a mere 16 pages long. It 
talked about Y2K. It introduced the brand-new concept of ordering products on 
the Web. Needless to say, we've come a long way, baby. 

Issue 2 announced the newly-created LookAt tool and sported our first 
Hot Topics Supplement. Issue 4 was the famous flip-side issue that covered both 
OS/390 and the new z/OS operating system, depending on which way you held it. 
Issue 5 introduced the ever-popular zFavorites mini-CD, and Issue 8 was our first 
foray into the new look and feel of the Newsletter. 

So, it seems we've kept up with the fast pace of change set by IBM itself— 
constantly bringing you the latest and greatest information in the world of z/OS. 
Your loyal readership has made sweeping success stories of the first 9 issues (a 
phenomon for which we are eternally grateful), and we're not stopping now! 

We have a fabulous anniversary issue planned for you! Once again, we've 
passed over the concept of a main theme in favor of bringing you a cornucopia of 
articles that cover a vast array of z/OS topics. Marna Walle, a popular contributor 
from issues past, agreed to write our featured article for Issue 10: 
Check it out for the skinny on locating and installing 
all sorts of handy z/OS Web deliverables. Also check out her other article, 
ogether: Merging 





o oing for helpful tips on migrating your 
/etc and /var file systems. 
This issue also sports informative articles on such scrumptious topics as the 
PUTDOC tool, the IBM Health Checker, ServerPac and SystemPac, block size, 
64-bit, console enhancements, the new euro support, SNA Enterprise Extender, 
documentation updates, customer feedback results, and much more! 

So, with all this priceless knowledge to absorb, you better hurry up and 
dig in! Don't forget to email us your ideas and thoughts (no "over the hill" jokes 
allowed), and don't forget your credit card for when you order our anniversary 
presents. Enjoy! 


- The Editors 
newsletr@us.iom.com 
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Z/OS download for dummies 


BY MARNA WALLE 





Ever heard of a z/OS® Web deliverable and 
wondered how the heck you'd install it? 
Ever stumbled onto a z/OS Web deliverable 
on the Internet, thought it looked strange, 
and then clicked somewhere else? There 
are lots of great new functions available 
on the Internet for your OS/390® or z/OS 
system. Once you ve learned about how 
they install, enhancements for your system 
are just a click away. 

Let’s look at the where, what, and 
how of the SMP/E installable Web 
deliverables, and make mention of one of 
the most popular Web deliverables, IBM® 
Health Checker for z/OS and Sysplex 
(which is not SMP/E-installable). 

First things first, though. Why are 
there z/OS Web deliverables? Stated 
simply, because we want you to be able to 
select new non-priced functions for your 
OS/390 or z/OS releases. The releases on 
which the Web deliverables are offered may 
or may not be currently orderable. Because 
we can't offer new features for products 
that aren’t currently marketed and we want 
to provide you with the functions in the 
quickest manner, we need to offer them 
another way. Enter the Internet! 


Where are the z/OS Web 
deliverables found? 

z/OS Web deliverables are found at 
www.libin.comyzseries/Zos/downloads/ 
There are SMP/E and non-SMP/E 
deliverables on this Web page. Let’s 
concentrate on the SMP/E installable ones. 
All SMP/E installable Web deliverables 


install in the same manner. 


What utilities are used to install a 
z/OS Web deliverable? 

Assuming that you are able to download 
from the Internet (through your Web 


browser) and upload to your z/OS host 
(through FTP, for example), there are 
only two other utilities that you need to 
be familiar with—the z/OS UNIX System 
Services pax utility and SMP/E. The z/OS 
UNIX pax utility can be found on your 
z/OS host system in the /bin directory of 
your version HFS. The pax utility makes 
a single archive file from many files, 

and un-archives those files in the HFS. 
The SMP/E utility, and the associated 
z/OS utilities it calls, like the program 
management binder, you should already be 
familiar with. 

Even though you may not know much 
about UNIX on z/OS, you will receive 
a pax sample job with the package. Just 
remember to submit the job from a user 
ID that has an OMVS segment defined. 
(That is, it is a user ID with OMVS 
authority.) 

There is a fairly new SMP/E function 
that you'll need to be aware of-—GIMUNZIP. 
This function simply takes an HFS file 
and creates SMP/E RELFILEs. Again, 


you ll receive a sample job to do this, 





and remember to submit the job from an 
OMVS user ID. The GIMUNZIP function 
is provided in SMP/E V3R1 (with z/OS 
V1R2 and later), and rolled back to 
SMP/E for OS/390 V2R10 and z/OS 
VIRI1 with PTF UR52471. 

If you want to perform hash checking 
during GIMUNZIP, you must configure 
ICSF. Hashing provides additional security 
and verification for the download file. 

See the ICSF configuration requirements 
in ICSF System Programmer's Guide, 
SA22-7520, under “Helpful Hints for ICSF 
First Time Setup.” 


What’s in a 2Z/OS Web deliverable 
package? 

A single binary file, containing all the 
SMP/E RELFILEs, and a ReadMe file 


constitute the download package. ‘The 





ReadMe file contains the instructions and 
sample jobs for the package. 

No service is included in the Web 
deliverables, so you'll need to get the 
service for the Web deliverable FMIDs 
elsewhere. Service is not included in your 
Web deliverable because the package is 
stabilized once it is made available. Service 
for Web deliverables is automatically 
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included in your regular preventive service 
vehicle for z/OS, like ESO or CBPDO, 
regardless of whether you downloaded the 
functions. 


How are z/OS Web deliverables 

installed? 

To install a Web deliverable, do the 

following: 

1. Go to wwwiibm.com/zseries/zos/ 
and select your download. 
There are several pages you need to 
click through to get to the actual Web 
deliverable files. You'll receive the 
two files: the pax binary file and the 
ReadMe file. 

2. Download the two files in the package 
to your workstation through your Web 
browser and upload it to your z/OS 
host using FTP, for instance. (An 
example is in the ReadMe file.) The 
ReadMe file contains sample JCL to 
process the pax and can be uploaded 
to a sequential file or to an HE'S 
file. The pax file contains the actual 
FMIDs and should be uploaded into 
an HES file. 


= If you use SMB (Server Message 





~ =" Block), you can omit uploading 
to the host by downloading to an shared 
directory. For instance, | have a directory 
in my z/OS HFS shared with my 
workstation as my M: drive, using SMB. 

When I download, I save the files on my m: 

drive, and then reference it directly from 

my z/OS system. See z/OS Distributed File 

Service SMB Administration, SC24-59 18, 

for more information about setting up 

SMB. 

Whatever method you use to get the 
files to your host, make sure that the target 
file system is mounted R/w (read/write) 
on z/OS, and you transfer the pax file in 
binary format. You'll need to write to the 
file system later. 

1. Followthe instructions on the Web site 
and in the ReadMe JCL. There are 
several steps in the sample ReadMe 
job that: 

a. Invoke the UNIX pax utility to 
extract the component archive files 
into the same HFS directory. (The 
HFS files contain the zipped up 
RELFILEs you will create in Step b.) 
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b. Invoke SMP/E to perform 
GIMUNZIP on the archive files. 
This produces SMP/E RELFILEs 
from the files in the HE'S directory. 

c. Invoke SMP/E to perform a 
RECEIVE on the FMID RELFILEs. 

2. Obtain service for the Web deliverable 
from your regular preventive service 
deliverable. (No service is provided on 
the Web deliverable.) 

3. Continue the installation, following 
the program directory available from 
the z/OS download Web page. From 
this point onward, the MID installs 
just as any other FMID does—with the 
SMP/E APPLY, ACCEPT that you 
know and love. 
















Where can I find the 
documentation for z/OS Web 
deliverables? 

The program directory is found on 
the Web deliverable page in PDF, 
BookManager® book, or browseable 
format. The documentation for the 
enhancement you downloaded can be 
found at the product’s online library. 


How does the IBM Health Checker 
download differ from other Web 
deliverables? 

IBM Health Checker for z/OS and Sysplex 
is a very popular download, but it’s not 


in SMP/E-installable format. (For a 
description of this tool, see 
for success” on page 14) It's very eaey 

to obtain and set up. You download it 

from the same Web site as the other Web 

deliverables, but the install process is a 

little different. 

1. Download three files: load library (as 
binary), sample library (as binary), and 
ReadMe (as text). Then, upload the 
load and sample libraries to your host, 
putting them in fixed-block 80-byte 
data sets. 

2. Enter the command TSO RECEIVE 
INDATASET(‘dsn’) on both of the 

host libraries to restore them 

into their original format. 

The load library will 

receive to an unblocked 

data set and needs to be APF- 
authorized. The sample library will 
use a fixed-block 80-byte data set. 


3. Follow the setup instructions in 
IBM Health Checker for z/OS and 
Sysplex User’s Guide, SA22-793 1. 
Briefly, you'll update what you want 
to override (sample USERPARM), 
allocate an IBM Health Checker data 
set to save storage across [PLs (sample 
job ALLOHCDA), and run the health 
check (sample job HCHECK). 

4. Review and enjoy the IBM Health 
Checker report! 

IBM Health Checker is provided as is, but 

you can offer comments and suggestions 

on a Resource Link forum. By subscribing 

to this forum, you can receive notifications 


of updates. Resource Link is found at 
Ready to download? Let’s go! 

You can see that z/OS downloads 

aren't hard, once you know how they 

are packaged, and understand the 

steps necessary to bring them to your 
z/OS system. Keep the download page 
bookmarked on your browser, so you can 


shop for new functions in a single click! 
Sas 


Suit yourself: Customized migration books for z/OS V1R5 


BY JIM BECKER 


For z/OS V1R5, the z/OS Migration book, 
GA22-7499, is expanded to cover all three 
supported migration paths. (For z/OS 

V1R4, it covered only one migration path.) 


The three migration paths are: 
¢ VIR4to VIRS 
¢ VIR3 to VIRS 
¢ VIR2 to VIRS. 


As an added bonus, you will be able to 
download a copy of the z/OS Migration 
book that is customized to your particular 
migration path. 
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For example, if you download the 
V1R4-to-VIR5S book, you will receive 

a PDF of the book that contains only 
the V1 R4-to-VIR5 migration actions. 
The V1R3-to-V1R5 and V1R2-to-VIR5 


migration actions are not included in your 
customized book. In other words, the book 
wont contain migration actions that don’t 


apply to your particular migration path. 
The customized migration books will 
be available with general availability of 
z/OS V1R5 from the z/OS Migration and 
Installation Web page at: www jibm.com/ 
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Come together: Merging your Tile systems 


BY MARNA WALLE 





It seems that at least one person at every 
conference I go to asks about z/OS UNIX 
System Services /etc and /var file 
systems migration. System programmers 
have their migration of PARMLIB and 
PROCLIB down pat, but it seems that 
migrating the /etc and /var file systems 
gives them a little more difficulty. Maybe 
it will be easier to migrate these two file 
systems when you know what they are 
intended for, how IBM delivers them, and 
you know about some UNIX utilities that 
may help you with the migration. 

As you probably know, since OS/390 
V2R9, the /etc and /var (as well as /dev 
and /tmp) file systems have been separated 
from the version (that is, the root) HFS, 
and cannot be shared between system 
images. The /dev and /tmp file systems 
are likely to be temporary file systems 
(TFS) and, as such, do not persist between 
IPLs. Therefore, no migration activities 
are necessary for these file systems. The 
files in /etc and /var, however, do persist 
between IPLs, and may require migration 
activities. 


letc usage 
/etc is the location for your own 
customization data for products. You 
can loosely think of it as similar to your 
PARMLIB. You set up the /etc files and 
you maintain their content. [BM products 
do create directories under /etc during 
installation, but IBM does not create files 
under /etc during SMP/E installation. 
Because IBM products do not create files 
into /etc, there is no possibility that 
SMP/E installation of an IBM product or 
service will overlay your own files within 
/etc. 

Consider the case of the two 
/etc files for your automount policy: 


/etc/auto.master (which contains the 
directories that will be monitored by 
automount) and /etc/u.map (which is 
the MapName file and contains the mount 
parameters). In the unlikely event that a 
change to the automount facility required 
changes to these customization files, 
migration actions would be necessary, and 
you would have to make the changes. 

Migration actions on the z/OS /etc 
files are documented in z/OS Migration. 
When upgrading other products, see their 
respective documentation for their /etc 
migration actions. 


/var usage 

/var is the location for IBM products to 
put their own customization and execution 
data. IBM products dynamically put 
information they need for their execution 
under this directory, and they need this 
information to be persistent between 
IPLs. /var files are not maintained by 
you although you need to make sure the 
/var file system is available to the IBM 
products on each image. The information 
that IBM products keeps within /var is 
not intended for you to directly edit or 
modify. It is for IBM product usage only. 
Like /etc, IBM products create directories 
under /var during installation. Unlike 
/etc, IBM products (during execution or 
customization) also create files in /var. 
However, IBM products do not install files 
into /var during the SMP/E installation. 

An example of /var usage is the 
printer inventory files for z/OS Infoprint® 
Server. Infoprint Server keeps a printer 
inventory containing information about 
the printing environment, maintained 
in the /var/Printsrv/master.db and 
/var/Printsrv/jestoken.db files. These 
printer inventory files are needed between 
IPLs and are not intended to be directly 
edited by the installation. 

There could be migration actions 
required for /var files although there 
aren't any at the moment. The specific 
action would depend on the migration 
needed. /var migration actions would be 
documented in z/OS Migration. When 
upgrading other products, see their 
documentation for their /var migration 
actions. 
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letc and /var file systems and the 
installation method 

There are different ways to install z/OS 
and z/OS products, such as CBPDO, 
ServerPac, and SystemPac®. After you’re 
done installing through any of these 
methods, the /etc and /var file systems 
contain approximately the same content, 
more or less, regardless of your method. 
For instance, whether you or [BM do the 
SMP/E installation work, /etc directories 
will be created. Whether you or IBM do 
some customization work, /var files will 
be created. 

Let’s look at the ServerPac installation 
method now, but remember that CBPDO 
and SystemPac are not really that different. 
SystemPac does more customization than 
ServerPac. Because of this, the SystemPac’s 
/etc and /var may have several more 
files and directories than ServerPac’s 
/etc and /var file systems. The number 
of directories and files may be less in 
CBPDO’s /etc and /var than ServerPac’s. 
Regardless, the same basic idea for /etc 
and /var migration remains. 


Delivery of the /etc and /var file 

systems in ServerPac 

ServerPac creates separate /etc and /var 

file systems that you load at the same 

time as the other file systems by running 
the RESTFS job. Once you have loaded 

your file systems, you will have to merge 
the ServerPac /etc and /var with your 

existing system’s /etc and /var. This 

is where the difficulties and confusion 

often lie with /etc and /var. Since /etc 

and /var are not shared between system 
images, this means you ll need to make the 
changes on each system’s /etc and /var 
file systems, as you deploy your ServerPac 
system. 

The contents of the ServerPac /etc 
and /var directories come from two 
sources: the product-supplied MKDIR jobs 
and from product customization performed 
by ServerPac for you. 

°  Serverpac’s /etc for z/OS contains 
directories, some symlinks (from DCE 
and DFS”, created by their MKDIR 
jobs), and possibly some IBM License 
Manager files (from ILM customization 
and can be discarded). 
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¢  ServerPac’s /var for z/OS contains 
several element directories and 
some OCSF files (created during the 
customization of the OCSF element 
under /var/ocsf, from the 
ocsf_install_crypto install script). 


UNIX utilities for helping with 

migration 

There are many UNIX utilities available 

that can compare and copy directory 

structures and files, but here are the ones 

I think may be most helpful for /etc and 

/var migration work: 

° diff: Add the -r option for recursion. 
This utility is very handy for 
comparing the path structures and 
file contents, and has many options 
available. I prefer this utility over 
dircmp (which has fewer options for 
directory comparisons) and cmp (which 
stops after the first difference in a 
file comparison, and the output from 
which is more cumbersome). 

¢ pax: Another utility you are probably 
familiar with. The -xrw option works 
like a copy (instead of making or 
extracting from a single file archive) 
for directories, symlinks, and files. 
Consider the -pe option for saving 
the attributes when doing the copy. 
The -k option prevents overwriting of 
existing files—for peace of mind that 
your existing files won't be overlaid! 


Migrating the /etc and /var file 
systems from ServerPac 

To figure out what you need to migrate, 
first compare the ServerPac’s /etc and 
/var file systems with your existing /etc 
and /var file systems. Mount a copy of 
your existing /etc and /var file systems 
to a location outside the ServerPac file 
system. For instance, you may have your 
ServerPac file systems at /ServerPac/ 
zOS R4/etc and /ServerPac/zOS R4/ 
var and your existing file systems at 
/Service/Imagex/etc and /Service/ 
Imagex/var. You may have several file 
systems to mount that are copies of 

each of your image’s /etc and /var file 
systems (ImageX, Imagey, and Imagez, for 
instance). To compare the ServerPac and 
existing system’s /etc and /var, you can 


run two UNIX commands. Examples: 
diff -r 
/ServerPac/zOS R4/etc 
/Service/ImageX/etc 
ditt =z 
/ServerPac/zOS R4/var 
/Service/ImageX/var 
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These command results will give you a list 
of the changes that your existing system’s 
/etc and /var file systems are missing— 
both the structure differences and the file 
content differences. 

Once you know the directories, 
symlinks, and files you are missing from 
your existing system, there are a couple 
of ways to propagate the ServerPac 
information forward: 
¢ You could use the pax command 

(with the -k option) to copy from the 

ServerPac /etc and /var file systems 

to each of your existing system’s /etc 

and /var file systems. Examples: 

pax -rvwk -pe 

/ServerPac/zOS R4/etc 
/Service/ImageX/etc 
pax -rvwk -pe 
/ServerPac/zOS R4/var 
/Service/ImageX/var 

The pax command is a good choice 

because it copies all files, directories, 

and symlinks for each file system from 
the ServerPac system using a single 
command without overlaying any 
existing files. 

- Or, you could rerun the product- 
supplied MKDIR jobs to recreate the 
directories and symlinks on each of 
your existing system’s /etc and /var 
file systems. (A list of the MKDIR 
jobs is found in the z/OS Program 
Directory and the other program 
directories for the products that were 
in your ServerPac order.) Don’t worry! 
MKDIR jobs are designed to be run 
multiple times without damaging your 
existing file system. 

For the files under /var/ocsf, 
re-run the OCSF product supplied 
ocsf_install_crypto install script. 
Or, you can combine these jobs and 
script them into a single batch job to 
make the execution more consolidated 
and repeatable. 

After you’ve made the changes to a copy 

of your existing image’s /etc and /var file 

systems, you can unmount them and use 
them for your deployment of the ServerPac 
system, as your schedule indicates. 

It is most important to note that 
you are using copies of your existing 
/etc and /var file systems, and that you 
are preserving what you had previously 
by modifying copies, so that your 
customization for those specific existing 
images is not lost. 
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More migration on the /etc and 
/var file systems 

As I mentioned earlier, there may still be 
migration actions to take on your existing 
/etc and /var files that will be indicated 
in the output of the diff command and in 
the z/OS Migration and other migration 
books. You may be able to do these 
migration actions prior to installing your 
ServerPac. Refer to the migration book 
for the specific migration action and the 
timing of that action. 


Feeling more enlightened about 
letc and /var? 

As you can see, there is some amount of 
manual work to analyze the differences, 
migrate any missing directories, files, 

or symlinks, and perform any specific 
migration actions within a particular 
file. | wish there were a silver bullet for 
making the /etc and /var migration 
easier, but understanding how IBM uses 
these file systems and how IBM delivers 
them will hopefully make you feel more 
knowledgeable about what needs to be 
done. 


| 
PUTDOC: Send us your tired, huddled masses ot Tiles 


BY BRENDA RAYNES 


The PUTDOC tool automates the steps PUTDOC highlights: 












for packaging and sending problem ¢ PUTDOC is a self-contained TSO/E 
documentation files to IBM support CLIST that is easily portable and 
personnel. Recent enhancements include configurable, and can be used to send 
data encryption, support for the naming your files to any UNIX-style or MVS" 
conventions required by the EMEA host. 

repository used byinternationalcustomers, ° Data can be sent in several formats, 
and support for PDSE input data sets. such as tersed (using TRSMAIN), 
PUTDOC is powerful and easy to binary, text (ASCH or EBCDIC, 
customize, requiring little time and effort depending on the target host), or 


TSO/E TRANSMIT format. Data is 
always transmitted using FTP. 


to package and send data sets. 








Supported file types now include MVS 
sequential, HE'S, PDS, and PDSE. 
(HFS files are copied to an MVS data 
set for transmission.) 

Very large data sets are automatically 
tersed and split into equal parts based 
on your customization options. 
Optional encryption is available for 
tersed data files. 

JCL is automatically generated to 
terse, encrypt, split, and send your 
files. 

Nicknames are included for the 
Testcase and the EMEA repository 
FTP sites. You can configure 
additional nicknames. 

Naming conventions on the EMEA 
repository are honored, and those used 
on the Testcase site enable support 
= personnel to easily ascertain data set 
format. 

Logging includes source and 

- destination file names, original data set 
-. attributes, date and time of transfer, 
~~ directory on the target server, and 


encryption key (if used). 


aa / , 
wf hive Testcase FTP service is not a secured 
7 site. If you require security beyond the 
~~. available encryption methods, terse your 
‘data set to disk and copy the result to tape 
for postal service mailing. 

For a complete description of the 
PUTDOC utility and to download the tool, 
~~ visit: techsupport.services jibm.comy 
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Prescription tor success: IBM Health Checker lor Z/OS and Sysplex 


BY DEBBIE BEATRICE AND THE IBM HEALTH CHECKER TEAM 


Availability: A principle that is at the 

very core of z/OS and OS/390 and 

their predecessors. It’s a topic that’s so 

important to [BM and its customers that 

we have written volumes of information— 
books, white papers, test reports, flashes— 
to help you improve availability. 

What’s that, you say? You haven't 
had time to keep up with all of this 
information? Do you wonder why IBM 
can't simply set its system configuration 
defaults to the recommended values? 

Sounds reasonable enough. However, 
a number of factors might prevent us 
from setting a configuration default to a 
recommended value, including these: 

- No single value is appropriate for all 
customers. 

* Some recommended configuration 
values are identified only over time, 
in production environments. 

- You might not revisit configuration 
settings after the initial setup. 

* Severe problems occur infrequently 
and often require your direct 
involvement to resolve, which makes 
automation difficult. 

- Environments are dynamic. New 
software, hardware, and maintenance 
can introduce changes to your 
configuration, which can make the 
initial recommended values obsolete. 


According to our analysis, human error 
accounts for more impacts to availability 
than either hardware or software failures. 
These errors can occur during your initial 
system configuration, or might result later. 
Often, these errors are difficult to detect. 


What if you had a tool to check 
your system for recommended 
values? 

Imagine having a tool that helps you to 
identify potential problems on your system 
before they impact your availability, or in 
worst cases, cause outages? Such a tool 
would check current, active settings on a 
z/OS system and compare those values to 
either [BM suggested values or values that 
you set. ‘he tool would be easy to set-up 
and use. And, available free-of-charge. 


Well, imagine no more! The tool is 


IBM Health Checker for z/OS and Sysplex, 


and is available for downloading to your 
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workstation from the 
z/OS Downloads page: 
www libin.comyzseries/ 
zos/downloads/ 


You can run the tool 






on all z/OS releases and on 
OS/390 V2R10. 
With IBM Health 
Checker, we did not limit 
our focus (or health 
checks) to only to the 
most complex areas of 
your system. Our analysis 
has shown that the simple things 
are also likely to cause availability 
problems. Also, while many of 
our checks are related to sysplex 
configurations, quite a few are 
applicable to a single system as well. 
Over the course of three versions 
of the tool, our list of checks has grown 
dramatically. We won't attempt to list all 
of them in this article (for that, see z/OS 
and Sysplex Health Checker User’s Guide, 
SA22-7931). Instead, this article provides 
an overview of several of the checks the 
tool can perform on your system. 


EMCS consoles checks 

For extended multiple console support 

(EMCS) consoles, the checks include: 

¢ Number of EMCS consoles. Over time, 
the number of EMCS consoles can 
grow, impacting performance. The 
number can be reduced only with a 
sysplex IPL. 

- Message scope and routing codes. 

To improve performance and reduce 
buffer shortages, you should limit the 
number of messages received by an 
EMCS console. 

- Hardcopy messages. An EMCS console 
that receives hardcopy messages from 
more than one system can become 
overloaded. 


system consoles checks 

For system consoles (hardware master 

consoles or HMCs), the checks include: 

* MVSsystem consoles should have only 
a local message scope defined, with a 
limited number of routing codes. 

* MVS system consoles should not 
run in problem determination mode 
during normal operations. 


z/OS HOT TOPICS Newsletter, Issue 10 








oo 


- ‘The active MCS system console should 
be defined with MASTER authority 
to provide a backup in case a problem 
occurs with the sysplex master console. 


sysplex console checks 

For sysplex consoles, the checks include: 

- MCS, SMCS, and subsystem consoles 
have assigned names. 

- Alternate groups are defined for 
consoles. Note that the alternate 
console specification, ALTCONS, will 
not be supported in the future. You 
should take steps to eliminate its use. 

* Consoles on each system have a 
console with master authority and 
command association. 

* The sysplex master console is active. 

- Messages sent to the console are 
limited to the console’s functions. 

- Action message retention facility 
(AMRF), if used, does not retain 
eventual action messages. 

- No console is configured to receive 
route code |1 messages. 


GRS checks 

For global resource serialization (GRS), the 
checks include: 

- A STAR configuration is used. 


* GRS synchronous reserve 


(SYNCHRES) processing is enabled. 





Storage checks and mapping 

For your storage configuration, IBM Health 
Checker provides a robust set of storage 
checks and storage maps to show changes 
between [PLs. These checks are critical 
because the virtual storage configuration is 
established during system initialization. 

Your virtual storage configuration is 
determined by a combination of system 
parameters and the size of modules in 
LPA and the nucleus. However, this 
configuration can change when you IPL 
the system, even if the system parameters 
do not change. For example, the 
installation of service can affect your 
virtual storage configuration. 

IBM Health Checker provides storage 
checks and reports that help you evaluate 
what has changed between IPLs: 

- Minimum storage for CSA, SQA, 

and private 
¢ Thresholds for CSA and SQA 
¢ Changes in size of CSA or private 

since the last [PL 
* Real storage availability 
* Reconfigurable storage (RSU) 

availability 
* Detailed storage maps for the current 


IPL and last two IPLs. 


Couple data sets and coupling facility 
For the coupling facility and its data sets, 
the checks include: 

* Primary and alternate couple data sets 
are defined and reside on separate 
volumes. Also, certain key couple data 
sets do not reside on the same volume. 

* Detailed report, showing status, 
relationships between coupling 
facilities, and structures. 


XCF checks 

For the cross-system coupling facility 

(XCF), the checks include: 

* XCF signaling is configured to avoid 
single points of failure for hardware or 
software. 

¢ Multiple XCF signaling structures 
do not reside on the same coupling 
facility, and various checks are made 
regarding active links. 

* XCF cleanup value is configured 
to allow for an adequate (but not 
excessive) amount of time for the 
partitioning process to wait if a 
system is removed from the sysplex. 


¢ XCF failure detection interval is 
coordinated with the spin recovery 
value. 

* Sysplex failure management (SFM) is 


active. 


Other important checks 

- Are available frame queue threshold 
values appropriate? This is particularly 
important due to a change in the 
calculation of values when you 
migrate from 31-bit mode to 64-bit 
mode. 

- Have LNKLST data sets grown to use 
secondary extents or secondary space? 
This could result in I/O errors. 

* Is dynamic allocation used for dump 
data sets? This avoids potential loss of 
data if dump data sets become full. 

° Is z/OS UNIX System Services 
configured properly? 


Getting started 

Many customers have been able to install 
the tool and run it in less than 30 minutes. 
Begin by downloading the tool from the 
z/OS Downloads page, as described in 


Marna Walle’s article [*z/OS download fo 


flummies™ on page 9 Upload the files to 


the host and follow the setup instructions 
in [BM Health Checker for z/OS and 
Sysplex User’s Guide, SA22-7931. 

Review the recommendations and 
values provided by IBM. You can find 
them in the USERPARMS data set. 


You have four options: 

1. Use the IBM values. 

2. Specify your own values. Include a 
date and reason or description for your 
values (to provide a history for any 
user-unique overrides). 

3. Change the severity of a check (high, 
medium, or low). 


4. Suppress a check, using the NOCALL 


option. 


The tool is a simple batch job that 
produces messages and reports as output. 
You can choose to have reports 

generated in either verbose mode or 
exception mode. We recommend using 
verbose mode for at least the initial 

run of the tool. Doing so creates a 
comprehensive report of values that 
comply with IBM’s selections (or yours), 
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and values that do not. Verbose mode 

also generates detailed displays for 

storage and coupling facility structures. 
After reviewing the report output, you 

have several ways of eliminating exceptions: 

* Modify system values. 

* Modify which values are checked by 
the tool. 

- Change the severity of a check. 





* Suppress a check if it is not applicable 
to your environment. 


Run the tool iteratively until you have no 

exceptions. When you are satisfied with the 
results, you can change the report mode to 
exception mode to include results only for 
checks that fail to meet criteria. 

Run the tool after each IPL. Also, you 
might also find it worthwhile to run the 
tool at regular intervals between [PLs, to 
check for changes to active system values. 


Specifying overrides to a check 
Here is an example of the syntax of the 


check for EMCS consoles. We provide the 


check with these values: 
CHECK (Number _EMCS_ consoles) 
Severity (High) 
DATE (20030102) 
PARMS (5000,10000) 
REASON (‘Excessive numbers of EMCS 
consoles cause slowdown’ ) ; 


You can change the severity or the 
parameters, but if you do, you must also 
update the date and the reason. In this 
example, we changed the severity to 
medium and updated the date and reason 


values: 
CHECK (Number _EMCS_ consoles) 
Severity (Medium) 
DATE (20031102) 
PARMS (5000,10000) 
REASON (‘Changed number of EMCS 
consoles to medium severity’); 


To supress a check, specify NOCALL: 
CHECK (Verify numbers EMCS_ consoles) 
DATE (20030402) 
NOCALL 
Severity (High) 
REASON (‘This check is not valid 
for our environment.’ ) ; 


Reading the messages 

Besides generating reports, IBM Health 
Checker for z/OS and Sysplex issues 
operator messages (WTOs) for any checks 
that end with an exception. The format of 
the messages is: 


HZSnnni<check_ name><Exception text> 
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When run in verbose mode, the tool 
issues messages to indicate whether 
your configuration values match I[BM’s 
(or yours). When recommendations are 
met, the tool issues messages such as the 
following: 


AVAILABLE FRAME QUEUE THRESHOLDS 
The LOW Available Frame Queue 
threshold is currently 200. This 
satisfies the IBM suggested minimum 
value of 200. 


AVAILABLE FRAME QUEUE THRESHOLDS 
The OK Available Frame Queue 
threshold is currently 400. This 
satisfies the IBM suggested minimum 


value of 400. 


For an exception to a recommendation, the 
tool issues a message like the following: 


Low severity Exception: IBM 
Criteria not met* 

REAL STORAGE AVAILABILITY 

V=R storage has been defined on this 
system. If V=R applications will 
not be run then IBM suggests that 
no V=R storage be defined. 


Action: If no V=R applications 

will be run on this system then 

set REAL=0 and VRREGN=0 in the 
ITEASYSxx member of PARMLIB before 
the next IPL. Note that REAL=0 

must be explicitly specified in 
order to remove V=R regions. If the 
REAL parameter is not coded then a 
default value will be assigned. 


IBM Suggestion: Do not define V=R 
storage if V=R applications are not 
required. 


IBM Reason: 
impacted. 


Performance might be 


Help is available 
To announce updates to the tool, we use 


the IBM Resource Link’ Web site at: 


www jilpm.com/servers/resourcelink 


You can use this Web site to: 
* Report problems. 

* Submit requirements. 

* Ask questions. 
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How did this begin? 
A hardy band of souls took on the 
challenge of creating a prototype and 
proving that the concept could work. 
Actually, this project was fortunate to have 
quite a few people who believed in its 
merits and provided their support. Among 
them, customers! We worked with some 
enthusiastic customers whose suggestions, 
input, and testing were key to making IBM 
Health Checker for z/OS and Sysplex a 
reality. 

For configuration recommendations, 
we relied on many sources: 


- IBM z/OS system test personnel 





- IBM z/OS service and support 
personnel 

* Parallel Sysplex® and z/OS 
publications 

* Parallel Sysplex Availability Checklist 


¢ IBM Redbooks” 
- Washington System Center Flashes. 


In less than a year, IBM Health Checker 
for z/OS and Sysplex moved from concept 
to first deliverable. We started small and 
built up. In fact, we’ve had two releases 
since February 2003 (our initial GA), with 
our latest in October 2003. 


Where are we today? 
More than 2000 people have registered 
to use IBM Health Checker for z/OS and 
Sysplex. With the comments we’ve received 
and our growing numbers of users, we 
have the catalysts we need to plan for 
bigger and better things in the future. 
Remember: An ounce of prevention 
is no farther away than IBM Health 
Checker for z/OS and Sysplex. Visit 
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What’s new with ServerPac for z/OS V1R5? 


BY JOFIN BELLS 


What’s new? 

Starting with ServerPacs delivered at the 

end of March 2004, at the same time as 

z/OS V1R5 availability, we have improved 

usability and added support for zSeries® 

i Systems (zFS). The big changes are: 
You don’t have to enter information 
about online DASD volumes. 

- There is full support for zFS data sets. 

* Unintegrated service is delivered in 
the SMPPTS data set. 


- Block sizes are optimized 


automatically. (See [‘When block size 
matters,” on page 14}) 


These changes apply to all ServerPacs, 
whether for z/OS or a subsystem like 
WebSphere® Application Server, DB2®, 


CICS®, or IMS”. (They also apply to 
SystemPac in dump-by-data set format.) 


Dynamic DASD information 

We all know how to initialize a volume, 
right? In fact, if you ask nicely, your 
friendly local storage manager will 
probably give you new system volumes 
already initialized with the volume serials 
you want. As long as they are initialized in 
advance and online, you won't have to tell 
the dialog all about each volume any more. 
Instead, you can tell it to figure things out 
on its own. 


How? Just leave the default alone! 

To do that, leave the new DYNAMIC 
DASD INFO variable set to ves, the 
default. Then, the dialog will find out what 
it needs to know about online volumes 
all by itself. If they are on IBM or IBM- 
compatible devices, all you need to enter 
are the volume serials. The dialog will find 
each volume’s size, device number, and 
geometry. If you opt to set the variable to 
No, the dialog will work as it did before, 
and you will have to define each volume 
manually. 

The only time you will have to tell 
the dialog more is if it does not recognize 
the device type. Were this to happen, you 
would have to provide the UNIT that 
should be specified to allocate data sets on 
the volume, and the dialog would figure 
out the rest. 


How was this volume defined? 

You can see how each device was defined 
by looking at the new display field, 
appropriately named How Defined, on 

the physical volume summary display. 
IBM means we primed the dialog with 
information about that device type and 
model, Dynamic means the dialog defined 
it automatically, and user means you 
defined the device. Also, dynamically 
defined devices will be shown with a 
model, device type, or both, that starts 
with a D for Dynamic. 


Automatic VTOC sizing, reserved 
Space, and JES2 spool addressing 
You can define a lot of different volume 
sizes on Enterprise Storage Server® DASD. 
The dialog calculates and sets the VTOC 
and VTOC index sizes for all volumes, no 
matter what size, device type, or model. 
The sizes are shown on the physical 
volume summary display panel. 

You can also define larger volumes, 
SO Reserved Space has been changed 
to accept a five-digit number. You can 
reserve all but one allocatable cylinder on 
a volume. That is, you can reserve space 
up to the volume size, minus the VTOC 
size, minus the VT'OC index size, minus 
one cylinder. 

Because spool data sets can be 
placed on volumes having more than 641K 
tracks, we added the RELADDR=ASNEEDED 
parameter to the JES2 SPOOLDEF 
statement. This tells JES2 to use relative 
track addressing when the end of a 
spool extent falls beyond the 64K track 
boundary. This way, if you use our inish 
deck for testing, JES2 will initialize no 
matter where you place your spool data 
sets, while minimizing the potential for 
causing problems with your exits. 


ZFS support 

z/OS UNIX System Services and 
Distributed File Services introduced 

the zSeries File System, or zFS, in z/OS 
V1R2. ServerPac allows you to use either 
an HES or a zFS for all z/OS UNIX 

file systems except the root file system. 
Because all supported levels of driving 
system support zF'S, we added support 
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to the installation dialog. You can also 
use ZFS file systems when installing 
subsystems using ServerPac on 05/390 
V1R10 and z/OS VIR1 if you have the 
required PTFs installed. (See z/OS and 
z/OS.e Planning for Installation, 
GA22-7504, for what you need to 
know about ServerPac’s driving system 
requirements—even for subsystems!) 

You can specify either HFS or ZFS 
as the data set type for a file system data 
set, either on the data set attributes panel 
or when using the CHANGE DSNTYPE 
command. While we were adding a new 
data set type to the dialog, we spruced up 
the data set displays. Now, the dialog will 
show you that data sets are HFS, PDS, PDSE, 
SEQ (sequential), vsam, or zFs, rather than 
showing a mix of DSNTYPE or DSORG. 

When you choose to use a zFS 
file system when installing z/OS, the 
installation jobs will help with the needed 
setup. They will format zFS data sets as 
Compatibility Mode Aggregates and add 
the required FILESYSTYPE and MOUNT 
parameters to BPXPRMxx parmlib 
members. The sample RACF® setup jobs 
will show what profiles are needed to start 


the new ZFS address space. 


Look, Ma, no service tape! 

When you unpack the box with your 
z/OS V1R5 order in it, don’t look for a 
service tape. Service that is not already 
installed comes already SMP/E-received 
in the SMPPTS data set. The SMPPTS is 
compacted to minimize the space needed. 
This lets you skip a step when you install 
unintegrated corrective service that was 
shipped with your order, or begin to install 
preventive service. 

Note that z/OS V1IR5 orders are built 
using z/OS VIRS SMP/E. It is identical 
to SMP/E for z/OS and OS/390 V3R2 
(5655-G44). This new level of SMP/E 
dramatically reduces the size of a different 
SMP/E data set, the SMPLTS data set. 
This should help offset the space needed 
for the SMPPTS data set. By the way, you 
can order SMP/E for z/OS and OS/390 
V3R2 for any supported release of 05/390 
or 2/OS. 

=a 
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When block size matters 


BY JORINTEERES 


Starting with ServerPacs delivered at the 
end of March 2004, we improved how 
block sizes are set in the installation 
dialog. These changes apply to all 
ServerPacs, including those for z/OS 
V1R5 or z/OS VIR4, or a subsystem like 
WebSphere Application Server, DB2, CICS, 
IMS, or NCP. 

The dialog used to have a default 
block size for every data set. These 
defaults were not recommended. Instead, 
they were usually chosen to make the 
dialog’s space calculations work well 
on different DASD types or to prevent 
specific problems. There was a CHANGE 
OPTIBLOCK command you could use 
to set recommended block sizes, but not 
everyone used it. ‘l’o complicate matters 
more, some people used optimized block 
sizes for DLIBs but not for target libraries. 

This led to some problems. For one 
thing, nearly all data sets require less 
space at recommended block sizes than at 
their old default block sizes. The difference 
varies from zero to 35% or so, but for 
most data sets it is 10-25%. When IBM 
builds your order, we add 10% to the used 
space for each data set, and set that as the 
default primary space. 10% free space is 
enough to make sure you can load all the 
data sets on different DASD types. But, it 
can be too little to let you install a chain 
of corrective service—or even try to install 
much preventive service. 

Also, there can be problems using 
SMP/E RESTORE when DLIBs are 
blocked with recommended block sizes 
but target libraries are not. SMP/E calls 
IEBCOPY using COPY (not COPYMOD), 
which often refuses to copy load modules 
from data sets with big block sizes to those 
with smaller block sizes. Usually, when you 
are running an SMP/E RESTORE, the 
very last thing you need is a complication! 

Last but not least, some customers 
asked us why, if we knew what the right 
block sizes were anyway, did we make 
people set them at all? They were right, of 
course. 

So now the dialog will set 
recommended block sizes automatically, 
making CHANGE OPTIBLOCK a fading 
memory. What block sizes will be set? 
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Generally: 

¢ For fixed (F), fixed blocked (FB), and 
variable (V, VB, VS, VBS) record 
formats, system-determined block size 
will be used. 

¢ For undefined (U) record format, the 
block size will be set to 32,760 bytes. 

¢ For most font data sets, the block size 
will be set to 12,288 bytes. 

- For data sets that the product owner 
sets to a specific block size, it will be 
that block size. 

* For UADS, which has no specific 
recommended block size, it will be 
modeled from your existing UADS 
data set. 


The dialog will generate jobs that allocate 
data sets using BLKSIZE(0) for many 

data sets, so that the DFSMSdfp” system- 
determined block size (SDB) is used to set 
their block sizes. Because the dialog does 
not know in advance what block sizes SDB 
will choose, block sizes and the data set 
sizes in blocks are no longer displayed. Of 
course, as with many rules, this one has 
an exception: If you define a data set to 
the dialog yourself, you can either set the 
block size or allow it to default to zero, for 
SDB. 

Naturally, we still have to display 
space somehow. Displays that are data 
set oriented are changed to show space 
in tracks. Also, you will specify space in 
tracks if you choose to change the size of a 
single data set. If you display the space for 
a particular data set, its size in cylinders is 
also shown. 

Space displays for volumes were 
changed, too. In Recommended System 
Layout, they show a percentage of each 
volume’s size. The same display now shows 
the space used by existing data sets and 
reserved space as a percentage of each 
volume’s size. The summary of physical 
data sets display now shows space in 
cylinders. And, it now shows the number 
of cylinders used by existing data sets on a 
volume and the number reserved. (Before, 
both displays merely showed whether a 
volume had existing data sets or reserved 
space, but not how much.) 

Another change to Recommended 
System Layout is that you can specily a 
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model-after volume to be used if the dialog 
needs to create more volumes in place of a 
device type and model. 


More free space 

If you have not been using recommended 
block sizes all along, with z/OS VIR5 
you will find that most data sets will use 
15-25% less space than they used to—even 
though we have not increased the default 
primary space allocations. Nonetheless, 
you should still increase the size of the 
data sets in your order if you plan to 
install preventive service. You probably 
will not need quite as much, but the first 
time around you should increase them by 
the same amount anyway. hen, check 
the data set sizes after you have installed 
preventive service using the new block 
sizes, and make a note to put the data sets 
on a diet the next time if appropriate. 


Did anything else change? 

Yes! See 
z/OS VIR5S?” on page 13} Also, these 
same enhancements are available with 
SystemPac if you order it in dump-by-data 
set format. 






Hey! Won't using block size 32,760 for load libraries 


waste a /ot of soace? 


BY JOHN EELLS 


Well, no. At first glance, one would 
certainly think so, because two 32,760- 
byte blocks will not fit on one track of any 
current direct access storage device. For 
example, on a 56,664-byte 3390 track, you 
might intuitively expect that one block of 
32,760 bytes would be written per track, 
leaving about 23,904 bytes unused. To put 
it another way, won't it waste nearly 42% of 
the space? After all, that’s how fixed blocks 
work. 

Well...no. Load libraries do not really 
have a fixed block size. Instead, a data set’s 
block size only sets the maximum size of 
a block. This is because the utilities that 
write to these data sets actually check the 
space remaining on a track before writing 
a block. If there are more than 1,024 bytes 
left on the track and 2,048 or more bytes 
to be written, they will write a short block; 
that is, one shorter than the data set’s 
block size. The rest of the data goes into 
the first block on the next track. 


Pop quiz question: If there are 56,664 
bytes to be written, will the utilities create 
a 32,760-byte block followed by a 23,904 
byte block? (See the answer below.) So, 
setting a smaller block size only forces the 
utilities to write more blocks than they 

need to. 








Why does it matter how many blocks are 
written? Every block that is written to 
DASD has count and key fields associated 
with it. And, under the covers there are 
cells or sectors of fixed size. Blocks cannot 
share cells or sectors. So on the average, 
writing a block wastes half a data cell or 
sector in addition to the cells used for the 
data, count, and key. Therefore, writing 
fewer blocks uses fewer cells or sectors to 
hold the same amount of data. 

For some data sets, none of this 
matters. Sometimes the size of the largest 
block that would be written for any 
member is smaller than the data set’s block 
size. There is no further improvement 
to be had by increasing the block size of 
any data set beyond the size of the largest 
block that could be written to it. On the 
other hand, using a larger block size never 
uses more space, so using 32,760 helps the 
data sets that can have big blocks without 
hurting those that will have only small 






ones. (If you want to see this for yourself— 
and for some reason, many people seem to 
want to—test with IEBCOPY COPYMOD 
and use data sets that have members with 
lots of contiguous text, like LINKLIB, 
and not with ones that have only small 
members, like CSSLIB.) 

But, but...isn’t half-track blocking 
just as good? Almost, but not quite. 
Sometimes, the space remaining on a 
track falls between half a track and 32,760 
bytes. If there is a large amount of data 
to write, the half-track block size will 
force the utility to split it into two blocks. 
Sometimes the next block cannot be 
placed on the same track as a result, which 
wastes even more space. This difference 
is usually very small, and affects few data 
sets. However, since we will pick the block 
sizes for you, we want to pick sizes that let 


you get the most out of every track. 
1 


“, Here, we continue our popular series of ServerPac 


hints and tips “fortune cookies” from ServerPac 
designer, John Eells. For the chef's first batch of 
| tasty morsels, see z/OS Hot Topics Newsletter 
issue #9. 


serverPac tip #25: ServerPac and SMP/E 
3.2—Putting all the DLIBs you need for 
LMOD build on one volume 

z/OS R5 SMP/E, also known as SMP/E Version 


3 Release 2, builds most load modules from the distribution libraries 


rather than keeping them in the SMPLTS data set. This means some 
DLIBs are now needed for APPLY processing. If you want to be able to 
copy just the DLIBs you need to other systems, it can be a lot easier if 
they are all on the same volume. 

To get them there, use the View and Change option of Modify 
System Layout to display data sets with a RECFM of U (undefined). 


Then, use the CH PVOL DLIB new_volume_serial command to place 

them on a new volume. After that, you will probably have volumes with 

a lot of free space where some DLIBs used to be; use the DSLIST line 

command from the Summary of Physical Volumes display and use 

the CH PVOL command to do most of the consolidation quickly. 
(Variation: If you SMS-manage your DLIBs and want to use 

a naming convention rather than volume placement, just use the b 


command instead.) 
a 
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signed, sealed, delivered... |’m your SystemPac! 


BY JUDY WASHO HARRIS 


You requested it, SystemPac delivers! Let’s 
take a look at all of the new enhancements 
we made to the CustomPac fee offerings 
based on customer requests. 


SFS enhancements 

The first bit of news is that selective 
follow-on services (SFS) is now electronic! 
For those of you not familiar with SF'S, 
now is your opportunity to learn about this 
great service. 

SFS packages are entitled (free!) 
follow-on maintenance offered within 
the CustomPac family of fee offerings— 
SystemPac, RefreshPac, the European 
Online Maintenance Information System 
(OMIS), ProductPac, FunctionPac, and 
SubSystemPac. 

An SFS package contains critical 
service information that became available 
alter your last CustomPac order or SFS 
package was built. Each SES package 
provides a report and includes SMP/E 
HOLDDATA, HIPER PTFs, PE PTF, and 
reach-ahead service, and is built according 
to a copy of your stored SMP/E CSI 
(consolidated software inventory) profile. 

SES packages help to stabilize the 
system, products, services, or functions that 
you have installed over a period of time. In 
Europe, you can specify the frequency and 
number of SFSs you want. In the other 
geographies, you can select the number of 
SFS packages (from 0 to 3) and specify the 
intervals between them (30 to 60 days). 

So now you have two options for 
getting your SFS: you can use the same 
physical media as your corresponding 
packaged offering, or you can use the new 
streamlined version delivered over the 
Web. 

What was streamlined from the 
original SFS? The electronic SES does 
not contain the CustomPac dialog and its 
associated installation documentation. Nor 
does it contain all of the PTFs in untersed 
format. Now, you can get just the JCL 
needed for batch JCL installation, with its 
installation guide and all PTs in a tersed 
format. Instead of waiting for your SFS to 
be delivered on physical media, you will 
receive an e-mail notification containing 
the instructions and the Web link to access 
to retrieve your order. Once retrieve you 


now have the batch JCL for a load-and-go 
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installation. What could be easier? If the 
resulting tersed PTs are over 1 GB, which 
is unlikely, we will ship your order using 
the alternate media specified with your 
associated CustomPac order. 

Before | go on about other 
enhancements to CustomPace, let’s turn to 
the CustomPac offerings that have SFS, 
starting with SystemPac. 


SystemPac enhancements 
SystemPac sounds very similar to 
ServerPac, and rightfully so. Why? Because 
SystemPac is built on top of ServerPac. So, 
everything that ServerPac has, SystemPac 
has too. For the new and exciting things 
that will be offered with ServerPac, see 


John Eells’ article 
erverPac for z/OS VIR5?” on page 13 


SystemPac is available worldwide. It 
is a system migration vehicle for z/OS and 
is the recommended IBM delivery vehicle 
for customers who want to save time, 
resources, and effort to migrate, install, 
exploit, and maintain their z/OS system- 
related products, and selected independent 
software vendor (ISV) products. 

SystemPac comes customized 
according to user specified parameters 
with guidance from IBM services 
specialists. It is designed to exploit new 
technologies and comes with a lot of 
enablements that you need to build an 
e-business environment. With SystemPac, 
you can have a functional z/OS system 
restored and [PLed within a day and have 
selected ISV products installed, too. 

So what’s the difference between 
SystemPac and ServerPac? A lot! Check 
out the That’s quite a list! 
But now you can see the value-add that 
SystemPac provides. 


RefreshPac 

RefreshPac, available worldwide, also 
includes SFS. RefreshPac is a software 
preventive service package that adds 
predefined collections of PTI's to a system 
to avoid problems that you have not yet 
encountered. You are required to send ina 
copy of your SMP/E CSI profile every time 
you request preventive service so that the 
service will be delivered for all products 
already installed on your system to the 
PUT-1 level, plus the latest recommended 
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service upgrade (RSU) level. Additionally, 
HIPER and PE-fixing PTF's are shipped, 
along with a customized installation guide 
and installation dialog jobs to install 

the service. Because your service order 

is based on your SMP/E CSI profile, it 
doesn’t include any extraneous service. So 
it can be delivered quickly on the physical 
media you specify. Plus, we APPLY 
CHECK the service we send you using 
your zones, and resolve any SMP/E return 
codes greater than 4. 


RefreshPac on Profile 

If you would like to get your preventive 
maintenance delivered electronically, we 
otfer that now too with Refresh on Profile, 
the new streamlined version of RefreshPac! 

Refresh on Profile allows you to order 
preventive maintenance based on your 
existing SMP/E CSI profile so that you 
do not have to send in a copy of your CSI 
every time you place an order. You can now 
use batch JCL for load-and-go installation 
and still have the option of using the 
installation dialog, if you prefer. No APPLY 
CHECK will be done, and therefore, no 
APPLY report will be included, resulting in 
much faster turnaround time. And, instead 
of waiting for your preventive maintenance 
to be delivered on physical media, you will 
receive an e-mail notification containing 
the instructions and the Web link to access 
to retrieve your order. 

To keep the process streamlined, SES 
packages are not available for Refresh on 
Profile. An SFS can always be ordered with 
the other CustomPac offerings, if desired. 
The service level of the PTFs and the 
content of the HOLDDATA will be exactly 
the same as that for RefreshPac, except that 
the PTs will be tersed. Now, you have two 
ways to order your preventive service in 
the CustomPac fee offerings: RefreshPac or 
Refresh on Profile, whichever best serves 
your needs. 

Refresh on Profile is currently only 
available in Kurope. However, you can get 
the same benefits of Refresh on Profile 
in the US by accessing IBMLink™ and 
using the Service Request and Delivery 
(SRD) application offered in SoftwareXcel 
Enterprise Edition for zSeries, requesting 
Order Preventive Service based on CSI 
profile. 





A side-by-side comparison of SystemPac and ServerPac functions. [| systemPac | | ServerPac 








Pre-planning functions 
HCD upgrade or migration (in selected 
geographies) 

Toleration, maintenance, research PITFs 
(in selected geographies) 

Installation and verification 


Customization functions (continued) 


SMP/E RECEIVE FROM NETWORK 
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Monoplex (single system sysplex) setup 
SMS active with small configuration 


UNIX System Services 
/dev and /tmp 


HFS and zSeries file system (ZFS) 
support 


Recommended system layout support 


Exploitation and e-business 
enablement functions 


z/OS UNIX System Services enabled 
in full function mode 





a 
¢ 
> 
'T) 
S 
‘e) 
=» 
fn 






Integration of subsystems: NCP, DB2, 
CICS, IMS 

Integration of selected ISV products 
Full volume dump (DFDSS) format 
Full volume dump (FDR) format 
system built and I[PLed with supplied 
IODF 

Collection of IODF through the Web 
(optional) 

No installation dialog to be executed 
using full volume dump 

Load-and-go on your preferred DASD 
types using full volume dump 

(driving system not required) 
Customization functions 
Customization parameter collection 
(assisted by IBM specialists) 

ISV products installed in an isolated 
environment 

subsystems isolated from z/OS or from 
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TCP/IP enabled using IBM defaults 


HTTP/WebsSphere Application Server 
enablement 


service update facility (SUF) enablement 
and Java™ setup 


initial setup 
initial setup 
setup 
setup 


CICS TS 2.2, and 2.3 Web support and 
3270 bridge initial setup 


DB2 8.1 and 7.1 ODBC and JDBC setup 
DB2 8.1 and 7.1 stored procedure (both 
DB2 and WLM established) setup 


MQSeries® 5.2.0 and 5.3.1 for z/OS and 
ES | | OS/890 initial setup 

WebSphere Application Server 4.0.1 

and 5.0.0 for zSeries initial setup and 
customization, including the following 
prerequisites: Resource Recovery 
services, Java for OS/390 1.3.x, Java for 
Z/OS 1.4.x, HTTP Server, DB2 8.1 and 7.1 
Subsequent maintenance functions 
SFS to stabilize installed systems 
products, and services 













User preferred SYSNAME defined 
Indirect cataloging and IEASYM 
specifications using full volume dump 
Dynamic products to zones assignment 
specification of TSO addresses using 
full volume dump 

Resource Recovery Services setup 
Enablement of Security Server (RACF) 
using STARTED class, provided with a 
sample RACF database 

WLM goal mode initial setup with 
sample policy 

Customized SDSF server (ISFPARM) 
support for multiple global CSIs per 
SREL using full volume dump 

IMS basic customization using full 
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Enablement of OS/390 and 
Z/OS System Logger 
selective JES installation and optional 
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OMIS 
SES packages are also available with 
Online Maintenance Information System 
(OMIS), which is available in Europe. 
OMIS is a vehicle for ordering corrective 
maintenance, toleration, and coexistence 
maintenance and HIPER/PE checks. The 
maintenance is based on a copy of your 
SMP/E CSI profile. This ensures that 
the ordered PTs are shipped with any 
necessary prerequisite and co-requisite 
PTEs. 

For OMIS, if your SMP/E CSI profile 
does not exist at IBM, you must send 
in your SMP/E CSI profiles by tape or 
through the Web using the CSI shipment 
application available on the following 
Web site: htips://www.canfim.cony] 
custompac/deliverable/omis. htm} 


OMIS is not a subscription service. 







It is an on demand PTF service. You can 
order OMIS through IBMDIAL (Europe’s 


IBMLink equivalent) or you can have an 





IBM support center representative who has 
done problem determination for you and 


has determined that one or more PTI's are 
required, place your order. You can also 
submit an OMIS order on the OMIS Web 
site mentioned above. 

OMIS is offered in the US in SRD 
by using Order toleration/coexistence 
maintenance based on CSI profile and 
Order HIPER/PE fixes or report, based 
on CSI profile. If your SMP/E CSI profile 
does not exist at IBM, use Upload your 
CSI profile in SRD. 

Here’s another new bit of good news. 
OMIS and SRD have been enhanced, 
too. If you are running SAP R3 on z/OS 
or 05/390, you can now easily order and 
install the most up-to-date z/OS or OS/390 
and DB2 toleration PTs recommended 
for installation on the system running 
SAP R3. These PTFs are tailored to your 
environment, based on your SMP/E CSI 
profile, and can be sent to you electronically 
within hours (or on physical media, if 
you prefer). Now that’s a new piece of 
information you should know about! 


Are you just a little curious? 
Try compiling your C/C** programs in 64-bit! 


BY ANUJA DEEDWANIYA AND BARBARA NEUMANN 


Are you planning to use 64-bit virtual in 
your C/C** application programs? Would 
you like to get an early start on porting 
your programs to 64-bit virtual? 

With the new 64-bit C/C** compiler 
available in z/OS VIR5, you can do just 
that! Use the new LP64 compiler option 
to select the LP64 programming model, 
in which the long type and pointer type 
are 64 bits in size. This option can detect 
compile-time problems when moving code 
from 32-bit to 64-bit. 

Compiling with LP64 doesn’t produce 
any object code in z/OS V1R5. However, 
you won't need that until you have the 
64-bit run-time environment. 

Curious? Check out z/OS V1IR5.0 
C/C** User’s Guide, SC09-4.767. @ 
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Use the new WARN64 

compiler option to help 

detect possible portability 

errors when moving code from 

32-bit to 64-bit, including: | 

- Loss of digits when you assign 
a long type to an int type 

* Change in the result when you assign 
an int type to a long type 

° Loss of high-order bytes of a pointer 
when a pointer type is assigned to an 
int type 

¢ Incorrect pointer when an int type is 
assigned to a pointer type 

¢ Change of a constant value when the 
constant is assigned to a long type. 


Always M., the header files containing 
the prototypes for any library functions 
that you call. This is particularly important 
under LP64, because the default return 
type is int, and a function returning a 
pointer or a long type will have the 
return value truncated by the caller. 
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There’s more! 

In this article, we’ve talked about sending 
your SMP/E CSI profile to IBM so 

that your maintenance can be tailored 
specifically for you. Previously, you had to 
download your CSI to your workstation so 
that it could be FTP’d to IBM. Sometimes 
the CSI could not get through your 
company s firewall. We now have a new 
option for you to send your CSI directly 
from your z/OS or OS/390 hosts to IBM 
using the F’T’P client without the need to 
download your CSI to workstations. This 
new option is available to you when you 
order a RefreshPac, use OMIS, or use SRD 
to Upload your CSI profile. 

Well, that was a lot of good news for 
you to absorb. There is so much more! 
We haven’t even touched on ProductPac, 
FunctionPac or SubSystemPac. You can 
get more information about these and the 


other CustomPac fee offerings by visiting 
us at: Www.libm.com/ca/custompad, 





Language Environment® in z/OS VIR5 
provides C/C** header files that are 64-bit 
capable. 

The new C/C** compiler reserves a 
__ptr32, to quality 
a specific pointer as 32 bits in size when 


new pointer qualifier, 


compiling under LP64. Use this qualifier 
to map an existing control block when you 
need to maintain the current structure size 
or access data in 32-bit storage. 

Also consider C data neutrality. The 
goal is to have common source code that 
can be compiled in either 32-bit or 64-bit 
mode. Use the new _Lpé4 feature test 
macro for 64-bit specific code. 

The effort you make today to compile 
your 64-bit applications early will make 
your work easier when it’s time to run 
them in your future 64-bit run-time 


environment! 
er | 


Objects of my affinity: 64-bit virtual shared memory 


BY ELPIDA TZORTZATOS AND MAGDALEN LEUNG 


The 64-bit virtual storage management 
support in z/OS V1R2 laid the foundation 
for a 64-bit operating environment by 
providing 64-bit data addressability 
within an address space and the ability 

to store and to manipulate data above 2 
gigabytes (the bar). New enhancements 
in z/OS V1R5 now allow you to share 
virtual storage above the bar across 
multiple address spaces. Middleware and 
applications can greatly benefit from 

the increased capacity by supporting a 
larger number of concurrent users and 
transactions. Database applications can 
take advantage by supporting a very large 
data cache across multiple address spaces. 
This article describes the 64-bit shared 
virtual storage support and illustrates how 
to exploit this support using new system 


services provided in z/OS VIR5. 


The 64-bit. address space 

Starting with V1R2, the z/OS operating 
system exploits the 64-bit virtual 
addressing capability of z/Architecture™ 
in order to provide for a 64-bit virtual 
address space. Each 64-bit address space is 
16 exabytes in size. The address space map 
below 2 GB has not changed at all. The 
area above 2 GB is for data only. Programs 
continue to be loaded and run in the first 
2 GB of virtual storage. 

Starting at 4 GB, the 64-bit address 
space is divided into three areas: low 
64-bit user private storage, the shared 
area, and the high 64-bit user private area. 
The shared area maps the same virtual 
storage range in each address space. The 
default shared area starts at 2 terabytes 
(TB) and ends at 512 TB. The shared area 
size can be specified with the HVSHARE 
keyword in IEASYSxx, or by specifying 
the HVSHARE keyword in the reply to 
the system parameters message (IEAxx). 
The minimum size you can specily for 
the shared area is zero and the maximum 
size is | exabyte. The specified size of 
the shared area is rounded up to the 
next 64 GB boundary to provide better 
performance. 


Comparing private and shared 
memory objects 
In z/OS, virtual memory above 2 GB is 


organized as memory objects which are 


created by programs. 
A memory object is 
a contiguous range 
of virtual addresses. 
The system allocates 
a memory object as 
a number of virtual 
segments. Hach segment is 
a megabyte in size and begins 
on a megabyte boundary. In z/OS 
V1R2, we introduced private memory 
objects which you could create by issuing 
the IARV64 GETSTOR request. With 
z/OS V1IR5, you can now create shared 
memory objects by issuing the [ARV64 
GETSHARED request. 

When a private memory object is 
allocated, all or part of the memory in the 
range covered by the memory object is 
addressable virtual storage. [he remainder 
is not addressable virtual storage and is 
called the guard area. A private memory 
object can be allocated with or without 
a guard area. After the memory object is 
allocated, the size of the guard area can be 
changed by an IARV64 CHANGEGUARD 
request. When a shared memory object 
is allocated, the entire range of virtual 
storage represented by the shared memory 
object is accessible. In other words, there 
are no guard areas in a shared memory 
object. However, there are ways to make 
a range of virtual storage within a shared 
memory object inaccessible. 

For private virtual storage above the 
bar, MEMLIMIT provides a limit on the 
above-the-bar virtual storage usage by 
an address space. Only the size of the 
usable part, not the guard areas, of private 
memory objects is charged against the 
MEMLIMIT. By contrast, shared memory 
objects that are used by the address space 
are not charged toward its MEMLIMIT. 

Private memory objects are owned by 
a task. Shared memory objects are owned 
by the system. Both private and shared 
memory objects are allocated by a single 
request and can be freed only in their 
entirety. Partial freeing is not allowed. 
Also, both types of memory objects have a 
single protection key and fetch protection 
attribute that cannot be changed after the 
memory object is allocated. 


February 2004 


z/OS HOT TOPICS Newsletter, Issue 10 






Creating a shared memory object 
The IARV64 REQUEST=GETSHARED 


service creates a shared memory object 


that can be shared across multiple address 
spaces. Shared storage above the bar is 
shared at the same address in each address 
space. In this respect, shared storage above 
the bar is like 31-bit common storage. 
Unlike common storage, shared storage 
above the bar is not addressable by anyone 
after it is allocated. When control returns 
to the program after a GETSHARED 
request, we consider the system to have 
expressed an interest in the shared 
memory object, or established system 
affinity to the shared memory object. 

The CHANGEACCESS parameter on the 
IARV64 GETSHARED service determines 
whether the scope of the shared memory 
object will be local or global. 

When CHANGEACCESS=LOCAL Is 
specified, each address space sharing the 
memory object can have its own view 
of the virtual storage range mapped by 
the shared memory object. Subsequent 
IARV64 CHANGEACCESS requests will 
affect the access view for only the address 
space specified on the request. 

When CHANGEACCESS=GLOBAL is 
specified, all the address spaces sharing 
the memory object will have the same 
view of the virtual storage range mapped 
by the shared memory object. Subsequent 
IARV64 CHANGEACCESS requests will 
affect the access view for all address spaces 
sharing the memory object. 


Accessing a shared memory 
object 

To get access to a shared memory 

object, your program needs to issue an 
IARV64 SHAREMEMOBJ request. When 
control returns to your program after a 


SHAREMEMOBJ request, the address 
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space specified on the request now has 
read/write access to the specified shared 
memory objects. When a SHAREMEMOBJ 
request is issued, we consider that the 
address space that was given access to the 
shared memory objects has expressed an 
interest in the shared memory objects, or 
established a local affinity to them. 

When an address space requests 
access to a shared memory object by a 
SHAREMEMOBJ request, the local address 
space affinity is associated with the cross- 
memory owning task for the address space. 
This is the task whose TCB address is in 
ASCBXTCB at the time the request is 
issued. When this task terminates, any 
local address space affinities associated 
with this task are implicitly removed by the 
system. An address space can issue more 
than one SHAREMEMOBJ request for 
the same memory object. To differentiate 
multiple requests for the same memory 
object, you must specify a different 
USERTOKEN on each request. 

The SVCDUMPRGN parameter on 
the SHAREMEMOBJ request determines 
whether or not the shared memory object 
should be included in an SVC dump 
when SDATA=RGN Is also specified. When 
SVCDUMPRGN=YES Is specified, an SVC 
dump will include (in its virtual storage 
capture for the owning address space) the 
virtual storage for this shared memory. 
When svcDUMPRGN=NO is specified, the 
SVC dump option spATaA=ReN will not 
include the virtual storage of this shared 
memory object in the dump. If there are 
multiple SHAREMEMOBJ requests for the 
same memory object by the same address 
space, the SVCDUMPRGN value specified 
on the last request is the value that is used. 

Recommendation: Consider whether 
you want your memory objects to have the 
SVCDUMPRGN=YES attribute very carefully. 
This attribute can greatly increase the size 
of an SVC dump when spata=Ren is also 
specified. Instead, you can use the L1sT64 
keyword when taking an SVC dump in 
order to dump virtual storage ranges above 
the bar. 

The example in Figure | illustrates 
what happens when an IARV64 
SHAREMEMOBJ request is issued for 
address space A. After the request is 
issued, address space A now has access 
to the shared memory object. Address 
space B still has no access to the shared 
memory object. Address space B will not 
have access to the object until an IARV64 
SHAREMEMOBJ request is issued 
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IARV64 REQUEST=SHAREMEMOBg, 
USERTKN=USRTKNS, 
RANGLIST=RLISTPTR, 
NUMRANGE=1, 
ALETVALUE=0, 

COND=YES, 
SVCDUMPRGN=YES 


Address space A 


Shared area 


Address space B 


High user 
private 


High user 
private 


Shared area 


Low user 
private 


Below the bar 


Low user 
private 


Below the bar 





Figure 1 - Accessing a shared memory object 


requesting that address space B be given 
access to the object. 





Changing storage access saacaeeatee 
To request that the type of access {0 
the specified shared virtual storage be 
changed, you can issue the IARV64 
REQUEST=CHANGEACCESS service. 
The CHANGEACCESS service allows you 
to control whether the sharing programs 
will have the following views: 

° READONLY: Programs that have a 
READONLY view to a shared virtual 
storage are not allowed to write to 
the data. Attempting to write to the 
shared virtual storage will result in an 
ABEND. 

© SHAREDWRITE: Programs that have 
a SHAREDWRITE view to shared 


virtual storage area can both read and 





modify the data in that virtual storage. 
* HIDDEN: Programs that have a 
HIDDEN view to shared virtual 


storage are not be able to read or 





write to the data. Attempting to read 
or write to the hidden shared virtual 


storage will result in an ABEND. 


The scope of the change is determined by 
your choice of LOCAL or GLOBAL on the 
CHANGEACCESS parameter specified on 
the IARV64 GETSHARED request. 

For local shared memory objects, 
only the address space specified by the 
ALET parameter on the IARV64 
CHANGEACCESS request is affected. 
When a program issues an [ARV64 
CHANGEACCESS request for a local 


shared memory object, the address 
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space that will be affected by the 
CHANGEACCESS service should 

have previously gained access to the 
shared memory object (by an I[ARV64 
SHAREMEMOBJ request). If this has not 
been done, the IARV64: CHANGEACCESS 
request will fail. 

For global shared memory objects, 
all the address spaces currently sharing 
the memory object are affected, so all the 
address spaces will get the same view. 
Subsequent IARV64 SHAREMEMOBJ 
requests for this memory object will 
also be affected until the next [ARV64 
CHANGEACCESS request is issued. 
When a program issues an [ARV64 
CHANGEACCESS request for a global 
shared memory object, no prior [ARV64 
SHAREMEMOBJ request needs to have 
been made for the global shared memory 
object. 

The example in Figure 2 on page 21 
illustrates how two different address spaces 
can have different views of virtual storage 
within a local scope shared memory object. 
Continuing from the example in Figure 1, 
an IARV64 SHAREMEMOBJ request is 
issued for address space B. Now, address 
space B has read/write access to the 
shared memory object. Next, an [ARV64 
CHANGEACCESS request is issued for 
address space A to its access to hidden for 
the shared memory object. 


Deleting a shared memory object 
When your program no longer needs a 
shared memory object, it can use the 


IARV64 REQUEST=DETACH service to 


delete the shared memory object. The new 


IARV64 REQUEST=SHAREMEMOBg, 
USERTKN=USRTKNS, 
RANGLIST=RLISTPTR, 
NUMRANGE=1, 
ALETVALUE=2, 

COND=NO, 
SVCDUMPRGN=NO 


IARV64 REQUEST=CHANGEACCESS, 
VIEW=HIDDEN, 
RANGLIST=RLISTPTR, 
NUMRANGE=1, 
ALETVALUE=0 


Address space A 


High user 


Shared area 


Low user 


Below the bar 


Address space B 


High user 


private private 


Shared area 


Low user 
private 


Below the bar 


private 


Figure 2 - Changing storage access for local scope shared memory objects 


AFFINITY keyword is added to the IARV64 
DETACH request to allow a program to 
specily whether it is deleting the local or 
system affinity to a shared memory object. 
Shared memory objects will be 
deleted when the following two conditions 
are met: 
1. All the local interests (affinities) 
from all address space sharing the 
object must have been removed by 
an IARV64 REQUEST=DETACH, 
AFFINITY=LOCAL request. 
2. The system interest (affinity) 
to the shared memory object 
must have been removed by an 
JARV64 REQUEST=DETACH, 
AFFINITY=SYSTEM request. 


When you specify the AFFINITY=LOCAL 
parameter, the system searches to see if 
the address space specified (or defaulted 
to by the ALET parameter) has access 

to the memory object identified by 

the USERTOKEN parameter. If the 
system finds that the address space has 
a local affinity to the shared memory 
object represented by the USERTOKEN 
parameter, that local affinity to the 
shared memory object is removed. If 
this is the last affinity for the object 

by this address space, the address 

space will no longer have access to the 
shared memory object. If this is the 

last affinity for the object in the system, 
and an JARV64 REQUEST=DETACH, 
AFFINITY=SYSTEM was previously 
issued, the shared memory object will be 


deleted. 


When you specify AFFINITY=SYSTEM, 
the system interest for the shared memory 
object identified by the USERTOKEN 
parameter is removed. If local address 
space interests to the shared memory 
object still remain, the shared memory 
object will not be deleted but no new 
IARV64 SHAREMEMOBJ requests can be 
issued against the memory object. 

Shared storage above the bar is 
similar to common storage below the bar 
in that it needs to be explicitly deleted 
or freed before the virtual storage is 
considered available for allocation again. 
Even though local address space affinities 
might be implicitly removed for you by the 
system when the cross-memory resource 
owning task terminates, the system affinity 
needs to be explicitly removed by an 
JARV64 REQUEST=DETACH, 
AFFINITY=SYSTEM request. If a 
system affinity or if all local address space 
affinities are not removed for a shared 
memory object, the memory object will not 
be deleted as mentioned above. 

Recommendation: To avoid leaving 
behind orphaned memory objects, 
establish recovery routines and RESMGRs 
for end-of-task and end-of-memory, to 
ensure that any local affinities and the 
system affinity for a shared memory object 
are removed. 

We hope that this article provides 
enough information and insights for you 
to design your programs to exploit 64-bit 
shared memory in the near future. 
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Need more information? 
Visit the z/OS Internet Library at 
and look for z/OS VIR5.0 MVS 
Programming Extended Addressability 
Guide, SA22-7614. 

Also, be sure to check out the 
zSeries 900 z/OS 64-bit Virtual Storage 


Roadmap at: 
liorary/whitepapers/gm130076.htm 
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On the go with the euro: The evolution of euro support in z/OS 
Language Environment 


BY KERSHAW MEHTA AND MICHAEL ZAGORSKI 


Throughout history we’ve seen examples 
of how technology has driven change in 
global economies. One such example is the 
tremendous effect Internet technology has 
had on stock trading. However, rarely do we 
see the converse, when technology needs to 
change due to geo-economic reasons. The 
implementation of euro currency is one 
such example. This article will explain the 
euro currency support that z/OS Language 
Environment currently provides, and what 
it is planning to provide, and the steps you 
can take to get there. 


Introduction 
In 1957, the European Economic 
Community (EEC) was established 
consisting of 6 countries: Belgium, 
France, Germany, Italy, Luxembourg 
and the Netherlands. In later years, the 
organization expanded to include Austria, 
Denmark, Finland, Greece, lreland, 
Portugal, Spain, Sweden, and the United 
Kingdom. 

Today, these countries are known 
collectively as the European Union (EU). 

In 1992, the EU member governments 
established the European Economic and 
Monetary Union (EMU), involving the 
introduction ofa single European currency. 
Countries can participate in the EMU 
by meeting a set of economic standards. 
Twelve of the EU countries have joined the 
EMU (today known as the Eurozone) and 
the single currency, the euro, was adopted 
as the common currency for the EMU. 

This single currency was first 
introduced on | January 1999, at which 
time both the euro and the existing 
national currencies were used and a fixed 
exchange rate was established with the 
European Central Bank. On | January 
2002, euro notes and coins replaced 
the national currencies and the single 
currency became a reality in twelve of the 
15 countries. Denmark, Sweden, and the 
United Kingdom have not adopted the 
euro. 

Just as the euro was introduced 
in stages, so was IBM’s support of this 
currency. This article highlights the 
three phases of support provided by the 
locales delivered with z/OS Language 


Environment. 
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Before we get to that, however, you're 
probably wondering, What is a locale? 
A locale is a collection of data that 
encodes information about the cultural 
environment for use by programs requiring 
internationalization support. ‘Typical 
elements of a locale include the native 
language, coded character set, collating 
information, character classification, 
character case conversion, date and time 
formatting, formatting for numeric and 
non-numeric numbers and monetary units. 
Locales are most commonly used by 
C/C** programs; however, they can be 
used with other programming languages 
that z/OS Language Environment 
supports. 


Phase I and Phase Il 
During the transition period from 1999 
to 2002, financial applications needed the 
ability to indicate monetary amounts in 
both the local national currency and the 
euro. For example: 
“Your balance as of today is 1 254,56 F or 
4. 938,24 €.” where the balance is stated in 
both French frances and euros. 

IBM shipped locale source files, 
charmaps and converters with the 
new euro symbol. Also, we changed 
the setlocale() C API to support 
modifiers, specifically the eeuro modifier. 
Applications that relied on locales to 
provide internationalization support would 
need to use the LC_MONETARY category 
in order to format the euro currency 


symbol. 


The original locale source files 





contained monetary formatting based on 
the local national currency in the 
LC_MONETARY category. For example, 
the locale source Fr_FR.IBM-1147 


contained the F symbol. The @euro 





modifier source contains monetary 
formatting for the new euro currency 
in the LC_MONETARY category. 
For example, the modifier source 

Fr FR.IBM-1147@euro contains the 


€ symbol. 





The following example will help to 
illustrate this concept using the @euro 
modifier: 

a. Load the French locale 

(Fr FR.IBM-1147). You can use 
the setlocale() C API to do this. 
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The LC_MONETARY category 


contains information for formatting 





in French francs. 

b. Call the strfmon() C API to format 
the amount into the string 
“| 234,56 F”. 

c. Set LC_MONETARY equal to 
Fr FR.IBM-1147@euro and load 
using setlocale( ). 

d. Call strfmon() again to format the 
(amount *4), assuming that 4 is the 
conversion rate for French francs to 
euros, into the string “4: 938,24 €”. 


e. Print using the values obtained. 





f. If the application must format in 
French francs again, set 
LC_MONETARY equal to 
Fr FR.IBM-1147 and load 
using setlocale( ). 





In 1998, for Phase I, we provided support 
for the @euro modifier for eleven of the 15 
countries in OS/390 V2R7, and rolled this 
support back to all supported releases of 
OS/390. In Phase I, we provided similar 
support for Denmark, Sweden, Greece, and 
the United Kingdom. 
For detailed information, including 

PTF numbers, visit: ww ibm.com/ 


Phase Ill 

To help you plan for the future, IBM 
announced its intention to ship Phase III 
support of the euro in z/OS V1R6. (See 
Software Announcement Letter 203-13 1.) 
This support is planned to provide euro 





monetary formatting behavior in the base 
locale for each Eurozone country. For 
these countries, the base locale source files 
shipped with Language Environment in 
z/OS V1R6 are designed to use the euro 
as their default local national currency 
symbol. As a result, an application that 
makes use of dual currency will require 
changes to ensure that it doesn’t report 10 
million lira one day and then report 10 
million euros the day after migrating to 
z/OS V1R6! 

Our Phase III support in z/OS V1R6 
is also planned to provide a mechanism 
to display the old local national currency 
for each Eurozone country. This support 
is needed for certain fiduciary obligations, 
such as life insurance policy statements. 


To meet this need, we will create a new 
@preeuro modifier that is essentially a 
copy of our old base locale for that country. 
The @euro modifier will continue to exist, 
allowing applications to continue to work 
unchanged in single currency (euro) mode. 
In the example described earlier, the 
application would now need to change to 
display the same dual currency statement: 
a. Load the French locale 
(Fr FR.IBM-1147). You can use 
the setlocale() C API to do this. 
Note that the LC_MONETARY 


category now contains information 





for formatting in euros. 

b. Call the strfmon() C API to format 
the amount into the string 
“4. 938,24 €”. 

c. Set LC_MONETARY equal to 
Fr FR.IBM-1147@preeuro and load 
using setlocale( ). 

d. Call strfmon( ) again to format the 
(amount /4), assuming that 4 is the 





conversion rate for euros to French 
francs, into the string “1 234,56 F”. 

e. Print using the values obtained. 

f. If the application must format in 
euros again, set LC_MONETARY 
equal to Fr_FR.IBM-1147 and load 
using setlocale( ). 





This change still allows the same balance 
to be printed, most likely with the euro 
amount displayed first: 

“Your balance as of today is 4 938,24 € 
or 1 234,56 F.” 


Technique to maintain single 
source 

At first glance, the application changes 
needed for Phase III could be viewed 

as incompatible and would therefore 
require maintaining two different source 
modules when the application is deployed 
on multiple levels of z/OS. However, here 
is a clever technique that will allow you 
to maintain single source modules. You 
can modify the application to check the 
operating system release level and take 
action accordingly. Here, you can use the 
uname() or __osname() C APIs. 


For example: 

1. Check OS Release level using 
_osname( ). 

2. IfOS Release is lower than z/OS 
V1R6, use the technique from 
Phase I. 

a. Load the French locale 
(Fr FR.IBM-1147). You can use 


the setlocale() C API to do this. 
The LC_MONETARY category 


contains information for formatting 





in French francs. 

b. Call the strfmon() C API to format 
the amount into the string 
“1 234,56 F”’. 

c. Set LC_MONETARY equal to 
Fr FR.IBM-1147@euro and load 
using setlocale( ). 

d. Call strfmon() again to format the 
(amount *4), assuming that 4 is the 





conversion rate for French francs to 
euros, into the string “4 938,24 €”. 
3. Otherwise, use the technique from 

Phase III. 

a. Load the French locale 
(Fr_FR.IBM-1147) using the 
setlocale( ) API. Note that the 
LC_MONETARY category now 


contains information for formatting 





In euros. 

b. Call strfmon() to format the 
amount into the string 
“4. 938,24 €”. 

c. Set LC_MONETARY equal to 
Fr FR.IBM-1147@preeuro and 
load using setlocale( ). 

d. Call strfmon() again to format the 
(amount /4), assuming that 4 is the 





conversion rate for euros to French 
francs, into the string 
“| 234,56 F”. 


4. Print using the values obtained. 


The next steps 
As new countries join the EMU and begin 
adopting the euro, we intend to create or 
change locales accordingly. We plan to 
use the same approach as before, where 
the @euro and @preeuro modifiers will 
allow for dual currency statements in the 
mandatory transition period. These new 
locales will be documented 
along with the existing locales 
in z/OS C/C** Programming 
Guide, SCO09-4:765. 
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Links to euro information 
The European Union: 


Euro information: 


europa.eu.int/euro/entry.htm! 


Did you know...? 
The euro is the official currency in other 
places besides the 12 current Eurozone 
countries, including the Vatican City, 
Monaco, Andorra, San Marino, and 
Liechtenstein. 

The EU has invited ten countries 
to join the Union on | May 2004. These 
countries are the Czech Republic, Poland, 
Hungary, Estonia, Latvia, Lithuania, 
Slovakia, Slovenia, Cyprus, and Malta. All 
countries except Cyprus have held their 
referendums and have voted to join the EU. 


Notice: 

All statements regarding IBM's plans, directions, and intent are 
subject to change or withdrawal without notice. Any reliance on 
a Statement of Direction is at the relying party’s sole risk and will 
not create any liability or obligation for IBM. 
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_——————— 
SNA: Dead or alive? Enterorise Extender saves the day! 


BY RANDY KUNKEL, DAN PATEL, AND SAM REYNOLDS 


“This report of my death was an exaggeration.” 
-Mark ‘Twain, May 1897 
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In 1897, when a reporter arrived at 
Mark Twain’s house to verify rumors 
of his recent demise, Mr. ‘Twain 
met the reporter at the door and 
delivered the above often-quoted 
comment. Well, it is now 2004, and 
IBM would like to make the same 
claim about the rumored demise (or 
more importantly, the lack thereof) 
of Systems Network Architecture 
(SNA). Despite the occasional 
rumor you might hear that “SNA 
is going away’ or that “IBM will 
soon discontinue support of SNA,” 
IBM’s intent is to support SNA for 
the foreseeable future. IBM recently 
issued the following Statement of 
Direction: 
It is IBM’s intent to support VTAM® 
in z/OS Communications Server for 
the foreseeable future. Customers 
have a substantial investment 
in 3270 and SNA applications. 
IBM continues to support and 
enhance VTAM’s capabilities while 
integrating it with new technologies. 
IBM has no plans at this time to 
discontinue SNA support in z/OS 
Communications Server. 

While SNA is not “going away,” 
it is evolving, and this evolution 
includes Enterprise Extender. 


What is Enterprise Extender? 
With the latest releases of 

z/OS Communications Server, 
S/390® and zSeries are now world- 
class platforms for native e-business 
(TCP/IP-based) applications. 
However, conversion ofexisting SNA 
applications to ‘TCP/IP-enabled 
applications can be economically 
impractical. In many cases, 

such conversions might even be 
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technically impractical due to the lack 
of source code and adequate skills for 
the specific application. An additional 
complication is the wide variety of 
SNA-based endpoint devices, such as 
banking ATMs. So, how can we enable 
IP applications and preserve SNA 
application and endpoint investment, 
while converging toward a single 
network protocol? With Enterprise 
Extender, of course! 

SNA has evolved from the 
traditional subarea networks that have 
dominated the enterprise network 
landscape for years. Enterprise 
Extender (EE) continues that evolution, 
providing a means for the efficient 
transport of SNA data across an [P 
network. 

EE is an industry-standard 
solution defined by the APPN® 
Implementers Workshop (ATW) and 
the Internet Engineering Task Force 
(RFC 2353). With EE, the rapid 
transfer protocol (RTP) endpoint views 
its interface with the user datagram 
protocol (UDP) layer of the stack as 
just another data link control, and 
treats the connection across the IP 
network the same as it would any SNA 
connection. 


High Performance Router’s (HPR) 
RTPcomponentprovidesthefollowing: 


¢ Error detection with selective 
retransmission of lost packets. 


¢ Nondisruptive reroute based on 
class of service requirements. 
HPR can preserve the session with 
minimal impact to the end user for 
planned and unplanned outages in 
the session path. In the event that 
no alternate path is available, you 
can configure HPR to preserve 
the session while the failing 
component is recovered. 
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¢ Proactive congestion control. 
KE brings with it an enhanced 
version of HPR’s adaptive rate- 
based (ARB) congestion control 
algorithm. ‘lhe newer version, 
responsive-mode ARB, is more 
ageressive in using the available 
bandwidth and more tolerant of 
variations in network latency. 


¢ Prioritization. 
The SNA priority field is 
mapped to the IP type of 
service (TOS) byte used by 
routing algorithms such as the 
Cisco Weight-Fair-Queueing 
algorithm. A set of standard 
UDP ports are also reserved 
based on priority, with packets 
mapped to them according to 


the SNA priority field. 


The IP layer handles packet 
forwarding for EE and can provide 
the following advantages: 

- The use of native IP routing 
can maximize router efficiency. 

- By using EE, SNA applications 
are positioned to take the full 
advantage of advances in IP 
routing technology. 

- Enablement of a single network 
transport can help reduce costs, 
simplify network management, 
and simplify network 
architecture. 


By providing a means of allowing 
convergence on an [P WAN as 

the sole network transport, KE 
pushes SNA to the “outside” of the 
network, which can eliminate the 
need for dedicated SNA hardware 
within the WAN itself. Native SNA 
becomes isolated to the hosts in 
the data center and to a few access 
routers, and possibly workstations, 
in the branches. 


ontinued on page 26 











To use the CD: Insert it in any standard CD-ROM and it should 


start automatically. 


If it does not, click on the Start button, choose Run... and then 


zFavorites! 
It’s the zFavorites for zSeries credit card CD! Youre gonna love this. It 


f helpful Web links, like for: 





has all sorts 








type x:\index.htm (where x is your CD-ROM drive letter) and 
press. Enter. 


Hardcopy 

Operating systems 
Software 

Language and tools 
ISV development and 
applications 





Product documentation 
Marketing information / 
Education 
Support 
Links to FREE downloads 
Redbooks sampler 
WebSphere 

XML 


Additional copies of zFavorites CD-ROM (GK3T-433 1-04) are 


separately orderable. 
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kor Readers 
FiO mel lOoles =allors 


e-mail us now to be notified when a new issue 
of Hot Topics is available! Every six months, 
we'll let you Know right when the new issue hits 
the stands. 


All you have to do is nab a copy through the 
IBM Publications Center, and you'll have the 
honor and bragging rights of being the first 
person on your block to be in-the-know about 
the hottest z/OS topics! 


Send requests to: 
newsletr@us.ibm.com 


Geographically Dispersed Parallel Sysplex 
The IBM Multiple Site Application 
Availability Solution 


So what is new 


with GDPS®? 


Planned Outage \ | 


Availability — 
Restartability |. _ Unplanned Outage 
Recoverability , _\ Disaster Protection / 

y ° 7 y 


Can you tolerate an application outage when disk 
subsystems fail or need maintenence? 


Do you require a heterogeneous solution that 
manages both your z/OS and open systems data? 


Do you want to extend your multi-site 
Parallel Sysplex cluster to 100 kilometers? 


New functions in GDPS - HyperSwap™ and 
Open LUN Management can help! 


For more information, visit: 


www isn. com/zseries/pso/ 
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Migration from SNI to Extended Border Node with Enterprise Extender 


ontinued from page 24 


EE for inter-enterprise 
connectivity 
EE can provide an ideal migration tool 
to enable an alternate inter-enterprise 
connectivity path for existing users of SNA 
Network Interconnect (SNI). The figure 
above displays the migration from SNI to 
Extended Border Node with EE. 

The APPN replacement for SNI is 
Extended Border Node (EBN). EBN is a 
technology first shipped on VTAM in 1994. 


It is now used by numerous customers to 





facilitate inter-enterprise communication 
and ease network consolidation after 
mergers and takeovers. Unlike SNI, 
which requires a gateway NCP to act 

as the network boundary, the boundary 
between two EBNs is represented by the 
intersubnet link (ISL) itself. Therefore, 
the ISL is not limited to only NCP-based 
connections, but instead allows other 
options such as MPC+ and EE. 

Because most enterprises today 
connect to an IP network (the Internet, 
intranet, or an extranet), EE emerges 
as an attractive way to connect multiple 
enterprises by using the existing IP 
connectivity. The two 5/390 or zSeries 
hosts that formerly acted as gateway SSCPs 
and ran the SNI protocol over NCP-based 
connectivity, now act as APPN EBNs with 
an KE connection mapped over the IP 
connectivity. Thus, gateway SSCP/NCP 
functions are no longer required, and SNA 
applications can achieve inter-enterprise 
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communication with any IP network 
attachment and connectivity supported by 
z/OS Communications Server. 


EE: The bandwagon is filling up! 
Numerous market factors, including 

the continued convergence of enterprise 
networks onto IP technologies and the 
withdrawal of the venerable 3745 from 
marketing, have led to a very rapid 
adoption of EE by IBM customers as a 
key component of SNA application access 
strategy. 

Recent SHARE and Networking 
Solutions Technical Conferences have 
included enthusiastic KE user experience 
presentations from a number of companies. 

Informations-Technologie Austria 
GmbH (iT-Austria) was an early adopter 
of EE on a large scale and has fully 
deployed the technology in a large 
network that enables branch access over 
an IP WAN and replaces SNI with EE and 
EBN. Josef Killmeyer, Network Design, 
Implementation, and Support expert for 
il-Austria, notes that “EE combines the 
strengths of both worlds: SNA and IP. EE 
has worked fine for us over more than two 
years without any outages.” 


EE performance 

In the past year, [BM has put significant 
effort into EE performance, to improve 
throughput and reduce CPU utilization. 


Improved throughput for EE 


There have been a number of 
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enhancements to HPR and EE processing 
that, when bundled together, provide 

a package that can provide improved 
throughput and possibly a modest 
reduction in CPU utilization. You may get 
this improvement for z/OS V1R2 (and 
later) by applying the PTFs for APARs 
OA02213 and PQ69398 and upgrading 
your OSA-Express microcode to 0326 (or 
later). 

Our tests of a z/OS VIR2 system 
with these PTFs and upgraded OSA- 
Express microcode displayed significant 
increases in throughput for streaming 
workloads, along with modest reductions 
in CPU utilization for both interactive 
and streaming workloads. For details of 
the test referenced throughout this article, 
including measured results, visit the z/OS 
Communications Server Web site: 


www jilbm.com/)software/network 


The message here is clear: If you 
are interested in helping to maximize 
EE performance in an OSA-Express 
environment, it is strongly recommended 
that you apply OA02213 and PQ69398, 
and upgrade to at least the 0326 level of 
OSA microcode. 


HPR Liveness Reduction for EE 

The RTP layer of HPR and the logical 
data link control (LDLC) layer of EE 
both maintain inactivity timers for the 
detection of partner reachability problems. 
However, when the RTP pipe is composed 
of a single EE link (or two EE logical hops 


across a connection network), maintaining 
the inactivity timers at both layers is a 
redundancy that uses CPU and network 
bandwidth (for keep-alive flows) to no real 
advantage, especially during periods of low 
activity levels. For that reason, we recently 
provided an enhancement that disables 
the RTP layer inactivity timer for pipes 
utilizing single-hop EE (or two-hop EE 
connection network) routes. The “HPR 
Liveness Reduction for EE” enhancement 
is available on z/OS V1IR4 with APAR 
OA04393, and on z/OS VIR5 with APAR 
OA04846. 

This enhancement has been running 
in production in one large customer 
shop (over 10,000 RTP pipes traversing 
more than 1200 EE connections) for 
several months now. This customer has 
seen a significant reduction in z/OS 
Communications Server CPU utilization. 
Note that this customer uses an RTP 
Model PU with prscnT=no to keep RTP 
pipes up all the time (even during periods 
of inactivity). Installations that do not 
employ a similar strategy will probably see 





smaller benefits. 


How about AnyNet? 

EE and ‘T'N3270 are the strategic protocols 
for SNA/IP integration. While still 
supported, AnyNet® is no longer being 
enhanced and is planned for withdrawal 
from support in a future release of z/OS 
Communications Server. EE is functionally 
superior and significantly outperforms 
AnyNet by all measures, exhibiting higher 
throughput and lower CPU utilization 
relative to AnyNet. 

To quantify the difference in 
performance, we recently ran 
head-to-head comparative benchmarks 
between EE and AnyNet. For both 
interactive and streaming workloads, 
AnyNet throughput was significantly 
lower than EE, while CPU utilization was 
significantly higher. The message is clear: 
For those looking to integrate their SNA 
applications with IP networks, and remove 
their dependencies on the 3745, EE is the 
preferred IBM solution! 


EE: Coming attractions 

EE continues to evolve. z/OS VIR5 

Communications Server includes a 

number of enhancements to EE function, 

including: 

* Support for multiple global and local 
EE connection networks 

* Support for multiple local static virtual 
IP addresses (VIPAs) for EE 

- EE connection network compatibility 
with [P networks employing network 
address translation (NAT) 

¢  [Pv6-enablement for EE 

- The ability to define model KE 
connections 

¢ An API for network management 
applications to retrieve information 
about HPR and EE usage and 


performance. 


Tell me more! 

For more information about EE, including 
announcements of enhancements to 
performance and functions as they develop, 
and details of the test referenced in this 
article, visit the z/OS Communications 


Server Web site: www jibm.com/software/ 
etwork/commserver/os390 





Notices: 


All statements regarding IBM’s future direction and intent are 
subject to change or withdrawal without notice, and represent 
goals and objectives only. 


Any performance data contained or referenced herein 

was determined in a controlled environment. Therefore, the 
results obtained in other operating environments may vary 
significantly. Some measurements may have been made on 
development-level systems and there is no guarantee that 
these measurements will be the same on generally available 
systems or that an individual user will achieve throughput or 
performance improvements equivalent to the numbers stated 
here. Furthermore, some measurements may have been 
estimated through extrapolation. Actual results may vary. Users 
of this document should verify the applicable data for their 
specific environment. 
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| can see clearly now: NetView for z/OS 


BY LARRY GREEN AND KIM BAILEY 


You're testing your new server code. The 
client is able to connect, but the server 
terminates with an error indicating that it 
received some incorrect data. You need a 
TCP/IP packet or data trace to see what 
the client is actually sending. It’s been 
a while since you've had to collect 
and format a trace. So you'll need 
to find your notes on that. Let’s 
see... Hmm... You have to enter 
some console commands to activate the 
SYSTCPDA trace component, and start the 
packet trace. After the trace is collected to 
a data set or from a dump of the TCP/IP 
dataspace, the traces must be formatted 
under IPCS. It’s not so difficult, but with 
your schedule, you really don’t have time 
for it all. 

Wouldn't it be nice to have a tool 
that didn’t require these tedious manual 
steps? Now you do. Using new function in 
NetView® for z/OS, you can quickly and 
easily capture and view formatted TCP/IP 
packet trace data in real time. When you 
need it. On demand. 


NetView does the work for you! 
NetView uses a new z/OS Communications 
Server interface that provides TCP/IP 
packet or data trace data, programmatically 
and in real time, to management 
applications that provide packet trace 
services, such as formatting. New NetView 
trace functions allow you to specily the 
TCP/IP packets that you want to trace. 
Then, Netview collects the traces from the 
TCP/IP stack and provides the formatted 


data right to your screen. 


How? 

It’s easy. NetView provides two new 
commands, PKTS and FMTPACKT, to 
capture and format the packet trace data 
collected by the TCP/IP stack. To get 
started, define an autotask to capture the 
data: PKTS DEFINE OPID=autotaskname 


Then, start capturing data: 
PKTS START TCPNAME=stackname 


If you need to collect trace data on an 
ongoing basis, you can have these two 
steps doneautomaticallywhenever NetView 
starts up. 
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To do this, place the following statement 
in the NetView style sheet, CNMSTYLE: 


FUNCTION.AUTOTASK.PKTS.stackname = 
autotaskname 


This statement associates an autotask with 
a stack. If you’re interested in more than 
one stack, simply add another FUNCTION 


statement for it. For example: 
FUNCTION.AUTOTASK.PKTS.stackname2 = 


autotaskname2 


We expect that stacks will usually be 
specified in CNMSTYLE. However, if 
you need to change definitions on the fly 
without having to recycle NetView, the 
PKTS DEFINE command lets you do that, 
as shown earlier. The INIT. PKTS=YES 
statement starts NetView’s data capture 
function. 

Although NetView is doing all the 
work to make packet trace gathering and 
viewing easier, it’s still the TCP/IP stack 
that collects the actual data. From the 
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stack’s perspective, collecting trace data 
has not changed. 

Let’s turn on tracing for the stack with 
the TRACE CT,ON, COMP=SYSTCPDA, 
SUB=jobname command, and tell the stack 
that you want packet trace data with the 
VARY TCPIP, , PKTTRACE command. 


What do you get for your efforts? 


The PKTS QUERY command lets you 
display the data you’ve captured. Only 
the interface names (LOOPBACK, 
TCPIPLINK) are readable. Most of the 
data is binary. It’s not terribly useful to a 
human, but it is suitable for use by REXX 
execs to analyze and respond to problem 
conditions as part of your automation— 
which we expect to be the primary use for 
the PKTS QUERY command. 

Using the default parameter values, 
the PKTS QUERY command reports 
on all TCP/IP stacks defined, and all 
addresses, ports, and interfaces. This might 
be more information than you need, so 
the PKTS command offers considerable 
flexibility in the area of filtering. For 
example, if you only want information 
related to a particular local address, 
you can limit the query output using a 
command like this: WINDOW PKTS QUERY 
LADDR=12.34.56.789. You can also filter 
on any combination of remote address, 
local or remote port, interface name, and 
time range. 

For something more useful 
to human users, let’s turn to the 
FMTPACKT command. Users familiar 
with Communications Server’s packet 
trace facilities will recognize many of the 
parameters available and find that the 
trace formatting is the same as that under 
IPCS. (You don’t have to learn to interpret 
a different trace format!) Using all the 
default parameter values, when you enter 
the WINDOW FMTPACKT command, 
you will see results like those shown on 
page 29. 

The results show information about 
all defined stacks, all addresses and ports, 
TCP, UDP, and so on—everything that’s 
been reported. (The command allowed 
the lines of this display to wrap so that all 
the information would be visible for our 
screen capture. For greater readability, we 


could have avoided wrapping by using the 


LINESIZE keyword to set a longer line 
length.) 

Like PKTS, the FMTPACKT 
command is very flexible. I you don’t need 
to display everything, but only want, for 
example, summary statistical information 
for a particular local address and local port 


combination, use a command like this: 
FMTPACKT QUERY LADDR=12.34.56.789 


LPORT=80 STATS=SUMMARY 


This command generates statistical reports 
showing byte and packet counts for each 
protocol, listing the number of records, 
the first and last record numbers, and the 
first and last record times for the specified 
address and port. 

If you need more detailed statistics, 
STATS=DETAIL provides the same 
information plus the number of records 
selected by record type, device type, 
jobname, linkname, and protocol number. 

If you need detailed information for 
TCP and UDP sessions, use FATPACKT 
SESSION=DETAIL. This provides link 
speed, data segment statistics, window 
statistics, information on data quantity and 
throughput, details on packets, including 
duplicate ACKs, out of order segments, and 
fragments, and much more. You can also 
use FMTPACKT as a NetView PIPE stage 
in a REXX exec to pass formatted packet 
trace data to automation. 


Suny Ta! WUNBER OF PACKETS: WA 
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Some TCP/IP configuration is 
required 

In order for applications such as NetView 
to use the new packet trace interface, the 
z/OS Communications Server TCP/IP 
stack must be enabled by specifying the 
new NETMONITOR PKTTRCSERVICE 
configuration statement in the TCP/IP 
profile. 

This ensures that network 
administrators allow the TCP/IP stack 
to provide this information to interfacing 
management applications. (Remember, 
tracing can affect system performance 
and the trace data may contain sensitive 
information.) 

Additionally, optional security controls 
using RACF, or an equivalent security 
product, are provided to allow network 
administrators to restrict access to specific 
management applications. 

Multiple management applications 
can use the new TCP/IP packet trace 
interface simultaneously. When you do 
this, the currently active TCP/IP packet 
or data trace options affect all applications 
collecting this data. In addition, any 
VARY TCPIP,,PKTTRACE or DATTRACE 
console commands that modify the current 
trace options will affect the trace data 
that is being collected by management 
applications that use the new TCP/IP 


interface. 
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Sample output from the FMTPACKT command. 
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Try it! 

Tivoli® NetView for z/OS and z/OS 
Communications Server work together 

to provide functions that make your job 
easier, helping you solve problems quickly, 
and improving your productivity. If you 
need formatted real-time packet traces, 
and you're tired of the multiple steps 
needed to obtain and view the data (that is, 
when you can find your notes reminding 
you what they are), why not try the new 
NetView packet trace function? We think 
you ll find it a valuable tool that’s quick 
and easy to use. 


You'll need: 
° NetView for z/OS V5R1 with APAR 
OA04304: 


¢ Communications Server for z/OS 
VIR5, or z/OS V1R4 with APARs 
PQ77244, PQ77837 and PQ79566. 
=i 
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I/O... I/O... It's off to 2990 we go! 


BY FRIEDRICH BEICHTER 


What’s new in 2/OS V1.4 HCD? 

The architecture of the IBM zSeries 990 
(z990) processor family differs significantly 
from its predecessor processor families 
(zSeries 900, and the G5 and G6 Parallel 
Enterprise Servers). From a Hardware 
Configuration Definition (HCD) point of 
view, the most obvious difference is the 
added ability to have multiple logical 
channel subsystems (LCSSs). With the new 
HCD on a z990, you can define 256 or 
more channel paths and 15 or more logical 
partitions, with each LOSS still adhering 


to the existing channel subsystem limits. 


As you might imagine, supporting multiple 
LCSSs on the new hardware required a 

major change to the HCD element of z/OS, 
both in the I/O definition file (IODF) data 
structure and in HCD’s ISPF user dialogs. 


In z/OS V1R4 HCD, the IODF hierarchy 
of objects adds a new object level, the 
channel subsystem, which exists between 
the processor and the channel paths, 
partitions, control units and devices, as 
shown here. 


channel 
processor amp subsystem _ Sain 


control unit 
device 





New object level in IODF hierarchy 


At the same time, we kept compatible the 
object layer for the previous processor 
families to allow different z/OS releases in 
a sysplex to access an IODF containing a 
z99() processor definition. 

We updated the HCD dialogs to work 
with processors having multiple LCSSs, 
as well as processors having only a single 
channel subsystem. If you define a channel 
subsystem for the z990, you will see a new 


dialog for this task. (If you are defining a 
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CSS for an older processor, the dialogs look 
much as they did before.) 


To maintain compatibility for the 


externals (panels, messages, and reports), 
we introduced a kind of generic notation 
to distinguish between 2990 and non- 
z990 processors. For a z990, we use a 
dot notation to specify the LCSS for the 
processor or channel path [D. 

Message CBDA137I, for example, 
shows the use of the dot notation: 


¢ For an older release of HCD: 


Link address on control unit 
4711 for channel path OA of 
processor PROC2064 required. 


¢ For z/OS V1R4 HCD: 


Link address on control unit 
4711 for channel path 0.0A of 
processor PROC2084 required. 


Also, z/OS V1R4 HCD is enhanced 

to support the z990’s ability to define 
channel paths that can be spanned across 
multiple LCSSs. Here, we kept the logical 
view of a channel path in each LCSS, 
while logically relating the definitions of 
the same spanned channel. 

Spanning channels adds complexity 
to the validation rules that apply to the 
hardware configuration; some of the 
rules are based on logical CHPIDs, while 
others are based on the physical channel. 
This makes the need for HCD more 
obvious than ever before. Along with the 
complexity introduced by corresponding 
changes to the syntax of the LOCP control 
statements, it would be difficult and time- 
consuming to do the hardware definition 
of a z990 processor directly through 
user-written [OCP control statements to 
generate an [OCDS. Fortunately, HCD 
shields you from that complexity and 
potential definition errors. 
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Regarding the logical I/O configuration 
of a z990 processor, there are two other 
prominent changes. First, the size of the 
hardware system area (HSA) is no longer 
determined by a specification in the Reset 
profile of the support element (SE). Rather, 
the HSA size is set by HCD (by the lOCP 
RESOURCE control statement). Instead 
of you having to specify the percentage 
of space in addition to the HSA space 
required by the I/O configuration of 

the active LOCDS, you now specity the 
maximum number of devices for each 


LCSS separately. 


fie Use HCD’s prompt function to see 





the number of currently defined 
devices and the maximum number of 
devices you can specily. 

Secondly, there is no longer a fixed 
default correspondence between the logical 
channel path (CHPID) and the physical 
channel location (cage. slot. jack) 
that can be changed through a CHPID 
assignment task on the SE. Instead, you 
define the correspondence between a 
CHPID and its physical channel in HCD 
by assigning an external CHPID to a 
physical channel [D (PCHID). 

The IBM Resource Link Web site 
offers a new CHPID mapping tool (CMT) 
that you can download to a workstation. 
You can use this tool as an aid in assigning 
PCHID values to your CHPIDs, based on 
your physical channels. The CMT takes 
your [OCP file as input and updates it with 
new PCHID values. You can then import 


the updated [OCP back into your IODF. 


®os 4 HCD V1R4 allows you to over- 
ait define CHPIDs (that is, define 
channel paths without available physical 


channels) by specifying a PCHID value of *. 
This approach can help you in planning 





a target I/O configuration if the physical 
channels are not yet installed. 


Migration to z990 made easier 

In z/OS V1R4 HCD, some functions 

(or tasks) are enhanced to allow you to 
more easily convert an existing processor 
configuration to a z990 processor 
configuration, as follows. 


Repeat/Copy task: Because each 
channel subsystem basically follows the 
limits of a z900 processor, you can copy 
the I/O configuration of a z900 or previous 
(G5 or G6) processor to a single LCSS of a 
z99( processor. For this reason, HCD has 
extended the Repeat/Copy task to support 
the copying of a processor configuration to 
a channel subsystem. As a result, you can 
convert multiple processor configurations 
to a single z990 processor configuration. 
(HCD also allows you to copy a channel 
subsystem configuration to a processor 


without LCSS support.) 


Migrate task: You can use this task to 
migrate I/O configuration statements 
from an IOCP input data set for a z900 
processor to an LCSS of a 2990 processor. 
Further, you can repeat the Migrate task 
for the other LCSSs, consolidating up to 
four 2900 processor configurations on a 
single z990 processor configuration. 

By the way, when you generate the 
z99( processor configuration back into 
I/O configuration statements (for example, 
using option 2.10 Build I/O configuration 
statements), the [OCP syntax is also 
converted. 


Copy task: This task is enhanced to 
handle ESCON® (SCTC) and FICON® 
(FCTC) CTC connections. Copy can 
indicate when the change of the channel 
subsystem or partition number needs 
adaptations to the control unit address 
(CUADD) in the target control units of a 
CTC connection. For the connections that 
are recognized by HCD, you can let HCD 


make the changes. 


After using Copy for a processor, 


‘channel subsystem, or partition, 
run the CTC Connection Report of HCD 
to check for incomplete CTC connections. 


=@ If you use Copy for a new LODF, 


your coupling facility connections 





are preserved. 


Extending HCD to mixed 
environments 

As part of the 2990 processor support in 
z/VM® 4.4, we ported HCD to z/VM. By 
extending HCD to the z/VM operating 
system, we ve made HCD function available 
throughout the zSeries platform. 

The z/VM system programmer can 
now use HCD to define and manage the 
I/O configuration, by using the z/VM 
device definition from the [ODF at IPL 
time, and using dynamic activate for the 
source and target IODF. 

In fact, you can even swap an [ODF 
between z/OS and z/VM! In a mixed 
environment of z/OS and z/VM, you can 
use HCD and Hardware Configuration 
Management (HCM) on your z/OS system 
to define the I/O configuration for both 
z/OS and z/VM in the same IODF. You 
can then export the production [ODF to 
z/VM and activate it there through HCD 
functions on z/VM (LOCDS download or 
the ACTIVATE command). As a further 
benefit, it is possible to use HCD for the 
I/O configuration of Linux running as a 
guest under z/VM. 

Note that we have not ported the ISPF 
dialog of z/OS HCD to z/VM. We have, 
however, included HCM in the z/VM base. 
You can use HCM as the user interface 
to HCD definitions. HCM provides a 
graphical user interface (GUI) that displays 
the physical I/O configuration in the HOM 
configuration diagram. 

While z/VM HCD contains only 
device support for a z/VM system, z/OS 
HCD contains the device support for both 
z/VM and z/OS systems. This is because 
the device support modules (UIMs) in 
z/OS are packaged with the device support 
products (such as DFSMS), whereas for 
z/VM, the UIMs are packaged with HCD. 


Defining the logical I/O 
configuration while documenting 
the physical configuration 

You can use HCD or HCM interchangeably 
to define the I/O configuration in an 
IODF. HCM detects whether an update has 
been done to the IODF directly from HCD 
and re-synchronizes itself to be ready for 
the next time the [ODF is accessed from 
HCM. Thus, when using HCM as a user 
interface, you can use certain functions 
available in HCD (for example, Copy 
Processor or Migrate I/O configuration) 
and then switch back to HCM. 
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Further exciting enhancements 
Other enhancements are provided with 


z/OS V1R4 HCD (FMID HCS7708): 


Data on the IODF prompt panel now 
includes the [ODF allocation size and 
the creation date. 

Performance of long-running HCD 
tasks (such as Copy, Migrate, Report, 
and Build Production IODF) has 
been significantly improved. 

By default, an IODF is now loaded into 
a data space. lhe source and target 
IODFs no longer consume storage in 
the master address space (for example, 
during the ACTIVATE command). 
The Switch Configuration detail 
report is redesigned; it’s more compact 
and arranged more logically. 

Last, but not least, the INITIODF 
utility no longer requires you to 
specity the size of an IODF. HCD now 
uses the allocated size of the VSAM 
cluster as default size of the LIODF. 


In summary... 


The new z990 support in HCD allows 
you to define multiple logical channel 
subsystems (LCSSs) on your z990 as 
easily as configuring the hardware of a 
Z900. 

Some HCD tasks are enhanced to 
allow you to more easily convert an 
existing processor configuration to a 
z990 processor configuration. 

By extending HCD to the z/VM 
operating system, we've made HCD 
function available throughout the 
zSeries platform. 

Together with HCM, HCD is a key 
part of the systems management suite 
on zoeries. 


For more information, visit the 


HCD/HCM Web site: 


www libm.comyzseries/zos/hcm| 
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Fuzzy dice optional: Driving ahead with the V1R4 Console 
Enhancements feature 


BY ED MEKEEL AND KEVIN KELLEY 


We love that feeling we get when we 
purchase a new car. We can’t wait to get 
behind the wheel and see how it handles 
the road. And, of course, there’s that new 
car smell. 

It doesn’t take long, however, for us 
to notice the other differences, too. We 
know, for example, that the new dashboard 
performs the same functions as the old 
one, but its layout is a little different. The 
buttons and switches are all there, but 
they're not in the same place and they 
might act differently. 

So we begin a short period of 
adjustment in which we adapt to the look 
and feel of the new car. Once we adjust, 
however, we might wonder how we ever got 
along with the old arrangement. 

We expect that implementing the z/OS 
V1R4 Consoles Enhancements feature will 
give you that new car feeling, along with 
the feeling that some things look and act 
differently than before. This article will 
point out some of those differences. (For 
an overview of the z/OS V1IR4 Consoles 
Enhancements feature, see Scott Fagen’s 
article “Sysplex message routing gets a 


face-lift” in Issue #9 of z/OS Hot Topics.) 


Naming consoles 

With the z/OS V1IR4: Consoles 
Enhancements feature, you must provide 
8-character names for the consoles 
specified in your CONSOLxx parmlib 
member. This change is required. Consider 
that doing this work now will also save you 
time in the future when we eliminate the 
limit of 99 MCS, SMCS and subsystem 


consoles per sysplex limit. 


A shift in resource consumption 
statistics 

With the z/OS V1IR4: Consoles 
Enhancements feature, more of the 
message processing takes place under 

the issuer’s unit of work. Previously, this 
processing took place under the operating 
system. 

If your company does charge-backs 
for I/T services, note that your SMF 
records will show an increase in resource 
consumption for the user. For those of you 
interested in making users responsible for 
their share of the resource pie, this change 
is a step in the right direction. 


Page 32 February 2004 


Y_s 


Fewer message-related 
throughput problems 
In Scott Fagen’s 

article (Issue #9 of 

z/OS Hot Topics), 

we learned that 

the consoles area 

has been enhanced 

with more space for 
buffering messages and 
an upgraded tasking 
structure to improve 
message traffic. Previously, during 
periods of high message traffic, you could 
reach a point at which a message issuing 
task would be made non-dispatchable 
until messages caught up, which would 
inevitably affect throughput. With the 
z/OS V1R4 Consoles Enhancements 
feature, you might still see WTO buffer 
shortage messages, but you should not 
experience throughput problems from 
message traffic. 


Spikes will be visible 

Continuing the theme of the preceding 
paragraph, some situations can generate a 
spike in message traffic, such as a problem 
with an application program. If not dealt 
with, these exception conditions can affect 
throughput. In the past, these conditions 
might have been hidden or dampened by 
bottlenecks in normal message flow. 

The Consoles Enhancements feature 
removes the bottlenecks, and makes visible 
any spikes in message traffic. As a result, 
your use of message suppression through 
the message processing facility (MPF) or 
automation will be an important aspect of 
planning for your implementation of the 
z/OS V1R4 Consoles Enhancements 


feature. 
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Tighter parameter checking on 
WTOs 


WTO processing (SVC 35) has been 
rewritten for the z/OS V1R4: Consoles 
Enhancements feature. As part of the 
rewrite, the interface is tightened to ensure 
adherence to documented syntax rules 
and to ensure that users with improper 
parameter lists cannot cause failures 

in z/OS. As a result, conditions that 
appeared to be acceptable in the past will 
now generate different return codes or a 
diagnostic ABEND. And, programs that 
create parameter lists without using the 
WTO macro might no longer function 
correctly. Also, the following parameters on 
the WTO macro are no longer supported: 
° PRTY 

© QID 

© BUSYEXIT. 


If you have code that specifies PRTY and 
QID, these parameters will be ignored. 

If you reassemble the code, the PRTY and 
QID specifications will cause errors and 
you will have to modify your code. If your 
code specifies the BUSYEXIT parameter 
on WTO, a severity zero MNOTE will be 
issued, indicating that BUSYEXIT is no 


longer supported with the z/OS V1R4 
Consoles Enhancements feature. The WTO 
parameter list is still updated to reflect 
BUSYEXIT, so if the code is executed in a 
pre-Consoles Enhancements environment, 
it will work. 

While the existing WTO macro 
supports return codes, very few programs 
check them. If the WTO macro is rejected, 
the issuer might not be aware of it. To 
clearly indicate error situations, you 
can use the new WTO macro to issue a 
diagnostic ABEND and write records to 
logrec to identify the problem. The issuer 
is not ended, but does, however, receive 
a return code from WTO. (The return 
code might differ from the code returned 
before.) To produce a dump, you can set a 
SLIP trap for the D23 diagnostic ABEND. 

For a description of the z/OS V1R4 
Consoles Enhancements changes to the 
WTO macro, see the book z/OS VIR5 
Migration, GA22-7499. 


Safety valve 
Let’s say, for example, that a console in 
the operations area is held and a backlog 
of undisplayed messages is building. With 
the z/OS V1R4 Consoles Enhancements 
feature, message processing for the console 
is suspended until the situation is relieved 
and the display of messages is once again 
keeping up with the roll rate. 

The task structure improvements 
in the Consoles Enhancements feature 
ensure that all messages will continue to 
be sent to MPF, the subsystem interface 
(SSI), SYSLOG, and OPERLOG. Also, 
the console’s processing of important 
messages will not be suspended. ‘This 
safety valve is intended to protect the 
health of the system and ensure that a 
message processing gridlock is not allowed 
to progress to the point where system 
availability is affected. 


Redirecting messages 

Today, through the CONTROL Q (K Q) 
command, messages queued to one console 
can be redirected to the hardcopy log or to 
another console. This rerouting function is 
no longer supported with the z/OS V1LR4 
Consoles Enhancements feature. With the 
restructured message flow, messages are 
sent to the hardcopy log much earlier in 
the process, ensuring that all messages 
can be viewed in the log. By the way, you 
can still use K Q to eliminate a console 


backlog. 


Future enhancements 

The z/OS V1R4 Consoles Enhancements 
feature is just the beginning of sweeping 
changes in the consoles area. Over time, 
we will continue to deliver functions aimed 
at further improving system availability 
issues. 

One area of focus will be to remove 
the limit of 99 MCS, SMCS and subsystem 
consoles in a sysplex. With this change, 
|-byte console [Ds would no longer be 
valid on WTOs and other macros as they 
are today. You will need to use console 
names instead. 

While |-byte console ids will be 
tolerated, the manner in which z/OS will 
treat these [Ds will change. Single byte 
console [Ds will be valid only from the 
standpoint that you will be able to define a 
default console to display messages issued 
using a l-byte console ID. Otherwise, 
1-byte console [Ds in a 4-byte addressing 
scheme will not behave as they do today. 
Likewise, you will no longer be able to 
direct the response from a command to 
a console using the 2-character decimal 
number (for example: D A,L=14). 

Because support for |-byte console 
IDs will be removed in a future release, it 
is advisable that you start to identify any 
references to 1-byte console [Ds in your 
applications. Places to look include: 

- WTO 

¢ MGCR/MGCRE 
- CIB 

¢ MPF exits 

> Ssi 


¢ Command exits. 


Try to identify any hard-coded command 
references using 2-digit decimal console 
numbers that might, for example, be in 
your automated operations scripts and 
change them to use console names. 
Included in the z/OS V1R4 Consoles 
Enhancements feature is an optional 
facility called the Console ID Tracking 
facility. Its purpose is to help you identify 
and display |-byte console |Ds in your 
environment. The Console [D Tracking 
facility provides these functions: 
¢ SETCON operator command for 
starting and stopping the facility. 
¢ DISPLAY OPDATA, TRACKING 
operator command, which allows you 
to display the current status of the 
facility. 
¢  CNIDTRxx parmlib member, which 
lists the found 1-byte console IDs. 


February 2004 


z/OS HOT TOPICS Newsletter, Issue 10 


¢ CNZTRKR macro, which allows a 
program to invoke the facility. 


For more information about the Console ID 
Tracking facility, see z/OS MVS Planning: 
Operations, SA22-7601. 


Happy driving! 

Where the heck ts the overhead light? 
It’s one of the questions we might find 
ourselves asking when we get into a new 
car. Once we find it though, we might 
wonder why our last car didn’t have it 
right there because it’s so much handier 
in that spot. 

Much of this fumbling around 
looking for buttons and switches in a 
new car is because you don’t get much 
training or notice of the changes. Or, 
you get a few pointers or tips—a crash 
course, if you will—just before driving 
your new car off the lot. The intention of 
articles like this is to give you an idea of 
what to expect with z/OS V1R4 Consoles 
Enhancements feature. By understanding 
these things early, we hope to help make 
your migrations as smooth as possible. 
Maybe you'll even want to hang some 


fuzzy dice from the mirror. 
ESS 
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Z/OS WebSphere Application Server InfoCenter “To Go” 


BY ANDREA GREGGO 


While online InfoCenters are wonderful 
at providing a communication channel 
between the product documentation 
teams and our customers by allowing 

fast updates and feedback options, there 
are times when a local instance of the 
documentation is preferable. In some 
cases, local documentation in the form of 
PDFs is fantastic—especially for printing. 
However, there are times when it is much 
easier to have the additional function of a 


Web-hosted InfoCenter available locally. 


To support the move toward local 

documentation, this article will describe: 

* How to build a local WebSphere 
Application Server InfoCenter using 
Eclipse open source technology. 

- The architecture of an Eclipse 
documentation plug-in. 


Building a local WebSphere 
Application Server InfoCenter 
WebSphere Application Server provides 
a local InfoCenter called the WebSphere 
Help System, available as a zip file at: 
www.ibm.com/software/webservers/ 
appserv/infocenter.html. 

The WebSphere Help System is 
offered to users interested in using the 
Eclipse open source technology as an 
information vehicle only. The WebSphere 
Help System does not provide the full 
function of the Eclipse IDE. If you are 
interested in using or learning more about 
Eclipse open source as an application 
development tool, you can read all about it 
at the Eclipse Web site: www.eclipse.org. 


Steps for building a local InfoCenter: 

1. Download the WebSphere Help 
System zip file. Unzipping the zip file 
to the local drive creates a folder titled 
WebSphere Help System on the local 
drive. You can choose to unzip the 
files to another directory on your local 
drive. 


2. Read the installation instructions in 
the getting started.htm file. This 
file is viewable in a Web browser and 
would have been unzipped as a result 
of the previous step. 
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Access this file, which is available 
in six languages in addition to the 
English version, by going to 
\WebSphere Help System\ 
getting started.htm. The 
getting started.htm contents 
describe in detail how to get the 
WebSphere Help System up and 


running. 


Note: Pay attention to the section 
in the getting started.htm 
file that addresses installing 

the WebSphere Help System. If you 
have an adequate Java Runtime 
Environment (JRE) installed, you 
should be able to launch the 
WebSphere help start .bat file to 
complete the install. If you do not, 
then it is necessary to upgrade the JRE 
before launching the WebSphere Help 
System. 


Launch the WebSphere Help System, 
using the WebSphere help start .bat 
file, found in the filepath: 
\WebSphere Help System\WebSphere 
help start.bat. Launch the bat file 
by double-clicking it in a Web browser 
or calling it in a DOS prompt. Ifa 
browser window opens with an empty 
InfoCenter, you are successful. 

If you do not get an empty 
InfoCenter, you need to troubleshoot 
the issue, beginning with the 
documentation provided in the 
getting started.htm file. Once 
successful, be sure to shut down the 
local InfoCenter before moving on to 
the next step. 


Download the WebSphere Application 
Server document plug-in zip files 

of choice. You can select from 
multiple product-specific WebSphere 


Application Server documentation 


plug-ins available at: www jibm.com) 
software/webservers/appserv 
infocenter.html 


Extract the document plug-in zip file 






set to the following path: Websphere 
Help System\eclipse\plugins. 
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Note: The architecture of each 
IBM document plug-in consists of a 


folder, usually named something like 
com. ibm.xxx.xxx.doc, that contains 
a series of XML files, possibly some 
additional folders, and a zip file called 
doc.zip. It is extremely important 
that the doc. zip file be left as a zip 
file and not extracted. Extracting 

the file will render the WebSphere 
Help System unable to read the 


documentation plug-in. 


You are now ready to launch your local 
InfoCenter using the WebSphere help 
start .bat file. You should see your 
documentation plug-in available in your 
local help system. If you so choose, you 
may download additional documentation 
plug-ins from IBM or third-party vendors 
using an Eclipse-based Help System like 
the WebSphere Help System. 


The architecture of an Eclipse 
document plug-in 
Document plug-ins can be as simple or as 
complex as they need to be. The figure on 
the bottom of page 35, for example, depicts 
the architecture of a basic document plug- 
in. 

Every Eclipse document plug-in 
must contain certain elements in order 
to function within the WebSphere Help 
System. The following key elements are 
necessary for a document plug-in to be 
functional. 


plugin.xml file: 
This file contains declarations of all of 
the individual TOC files that make up the 
contents of a document plug-in. If a TOC 
file is not declared in the plugin.xm1 file, 
it will not be called into the document 
plug-in. 

In this example, note the extension 
point. All document plug-ins need to use 
the following tag in order for the help 


system to recognize it. 
<extension point= 


"“org.eclipse.help.toc”> 


It is also good to note that toc_1.xml 

is declared with the primary="true” 
attribute. This informs the plugin. xml file 
to read toc_1.xml1 as the main TOC file. 


toc_x.xml file: 
A TOC file is an XML file that literally 
acts as a table of contents. The naming 
of a TOC file does not have to conform to 
the example used in this article. However, 
it is good to plan ahead, especially when 
developing complex document plug-ins. 
This example is very simple, but 
still demonstrates the key elements of a 
toc.xml file. Additionally, the <link EOe= 
tag is shown. This tag allows you to pull 
other toc.xml files, in their entirety, 
into one main TOC file. This is an ideal 
solution for simplifying extremely complex 
document plug-ins. 


doc.zip file: 

This file is designated as the content 
repository. It remains as a zip file to help 
manage the size of large document plug- 
ins. For the purposes of the examples in 
this article, we use HTML files for content. 
This is not the only acceptable content 
format, however, as PDF, TXT, DOC, and 
others are also acceptable. 

Very simply, this architecture works 
like this: The plug-in file declares and 
validates the toc.xm1 file(s), while the 
toc.xml file(s) call in the actual content 
from the doc. zip file. 

ia) 


Here is an example of a plugin.xml file: 


<?xml version="1.0"” encoding="UTF-8"”"?> 
<?NLS TYPE="org.eclipse.help.toc”?>s 


I a a 
<!-- This is the plugin for declaring the help --> 
LoS) =—SS=S=S = 555 SSS = SS SS SS SS ee a= SKS 
<plugin name = “WebSphere Application Server for z/OS” 

id = “com.ibm.websphere.zseries.doc” 

version ="5.0.0" 

vendor-name = “IBM”> 


<extension point="org.eclipse.help.toc”> 
<toc file="toc_1.xml” primary="true” /> 
etoc-tle="toe 2.2ml” /s 
<toc fle="toc 3.21” /> 
</extension> 
</plugin> 


Here is an example of a toc_x.xml file: 


<?xml version="1.0" encoding="UTF-8"?> 
<?NLS TYPE="org.eclipse.help.toc”?> 


<!-- Define the “info set” --> 


<toc label="WebSphere Example Doc plugin” 
topic="doc/example.html” > 
<topic label="My docs” href="doc/my_ docs.html” > 
“link toc="toc 2.20” 7s 
</topics 
e/tocs 





Architecture of a document plug-in 
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Climb on up: PDF extended shelves are here! | 


BY SHIRLEY SWENSON 


Since we first offered the OS/390 books 
in Portable Document Format (PDF) 
and began shipping PDF files as a 

print solution, customers have asked for 
viewing and library management of the 
PDFs, similar to what we provide for 


BookManager files. 


We responded to customer comments such 


as these: 

¢ “Need to handle non-IBM PDF docs 
better.” 

> “Need a SoftCopy Librarian that 
handles PDF files.” 


- “T would like to see tools for managing 
PDF format books that are equivalent 
to the tools for managing the 
BookManagerformatbooks. Preferably 
the same tool.” 


Well, PDF extended shelves have arrived, 

along with extended shelf support in the 

following IBM softcopy tools and products: 

-  Softcopy Reader V3.0 or later to access 
groups of PDFs and to create and 
modify extended shelves 

°  SoftCopy Librarian V4.2 to download 
and manage PDF's 

¢ Library Server for z/OS VIR5 
(previously known as BookManager 
BookServer) to access groups of PDFs 
on the Internet or intranets 

¢ Program for setting autorun 
preferences on the softcopy collections 
to accommodate selections for PDF 
extended shelves. 


Though you can now use these same tools 
to access and manage groups of PDFs as 
you use for BookManager books, reading 
the PDF files still requires a separate 
program, such as Adobe Reader. Also, you 
cannot use Softcopy Reader or other IBM 
reader programs to search individual PDI's 
or extended shelves of PDFs. Because 
PDFs don’t have a search comparable to 
that of BookManager books, there are no 
index files to go with the extended shelf 
files. 


What exactly is an extended shelf? 
An extended shelf is an XML file that lists 
a group of PDFs, typically PDF files for a 
particular product library, such as z/OS 
V1R4.0 UNIX System Services or CICS 
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VSAM Recovery V3.2. An extended shelf 


(XKS file) for a PDF product library is like | 


a bookshelf (BKS file) for 
a BookManager product 
library. It lists the files in 
the product library and is 
used by a number of IBM 
soltcopy tools and products 
to help users access the 


-* 


PDEs as a group. 

For example, you can 
use the PDF extended 
shelves to: 
¢ See a list of the 

PDFs as a group or create and modity 

extended shelves of PDFs, both 

IBM-supplied and non-IBM files, 

using Softcopy Reader 
- See a list of the PDFs as a group using 

Library Server for z/OS VIR5 
¢ Launch a PDF using your preferred 

PDF reader by clicking on the PDF 

entry in the extended shelf list 
- Copy the PDF files as a group to your 

repository and manage them using 


SoftCopy Librarian. 


Extended shelves make your job of 
managing softcopy documentation easier. 
Initially, extended shelves include only 
PDF publications. Additional publication 
formats are expected to be added to the 
extended shelf format in the future. 


When did extended shelves 
become available? 

IBM introduced extended shelves (XKS 
files) for PDFs in August 2003 with the 
VM Collection and in September 2003 
with the VSE Collection. In October 2003, 
the z/OS V1R4: collections and the final 
editions of the OS/390 collections included 
extended shelves for the first time. All 
subsequent zSeries software collections 
will include these extended shelves for 


accessing and handling PDFs. 


What can I expect in the future? 
The ability to manage PDFs similar to 
BookManager files is just the first phase 
of our rollout for extended shelves. Next, 
we ll provide mixed shelves of both PDF 
and BookManager files. So, if you have 
corresponding BookManager files for the 
PDFs in your extended shelves, you will 
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be able to search the extended shelves. In 
the final phase, we plan to deliver mixed 
shelves and full PDF search capability 
even if a corresponding BookManager file 
doesn’t exist, as well as search for other 


document types, such as HTML files. 


How do I use PDF extended 
shelves for z/OS? 

You must install Softcopy Reader V3.0 

or later and use z/OS collection files 
(October 2003 or later) that include PDF 
extended shelves. Or, use Library Server 
for z/OS V1R5, which supports PDF 
extended shelves. Remember, you can now 
use SoftCopy Librarian V4.2 to download 
groups of PDFs to your host, server, LAN, 
or workstation repository and manage 


PDFs as well as BookManager files. 


How can I build my own extended 


shelves? 
‘PDF extended 


See Geoff Smith’s article 

shelves: Here’s how!” on page 37|for a 
quick tutorial on creating your own PDF 
extended shelf. 


Why not try the new PDF extended 
shelves? We think this support will 










make it easier for you to access and use 
your soltcopy publications. Let us know 
what you think. Send your comments to 
mhvrcfs@us.iom.com. 


SESE ee 
PDF extended shelves: Here’ Ss NOw! 


BY GEOFF SMITH 








in See 

ee le ees 

Gers O- FF Sieh eae) Ge 
Suppose you have several documents related to Ages (J) Crista Pandbeaks 
Linux on the mainframe and they are all in PDF 
format. The problem is that whenever you want to 
read one, you open the folder and all you see are 
those weird-looking softcopy file names. If you 
rename them in Microsoft Windows, you will break 
any cross-document links between them, so that’s 
not a good idea. There is a solution. Use the IBM 
Softcopy Reader to create an extended shelf! 

Let’s look at the steps for creating a new 
extended shelf. For this example, we copied the 
Redbooks and Redpapers that shipped on the August 
2003 edition of zFavorites collection disk to our 
workstation C drive. 


xt he 
ae 





Steps to create a shelf of frequently used Redbooks 


1. Start the Softcopy Reader’s Shelf Organizer using 


: o. If you want to add another PDF document to the 
the icon shown. Make sure the path to the files you Mi) 


shelf, click on the right-hand side of the Create 





want to add has been specified in the al Extended Shelf dialog and drag the window to make 
User Defined Directories. Les it wide enough for you to see the three required fields. 
(Columns with an asterisk are required.) The file name 
2. From the Shelf Organizer title bar, click Jy rp eypeerigete is already filled in for you. 


File, Create Shelf. 

6. Enter an ID value and the title of the PDF. (These are 
the only required fields.) The ID value can be the same 
as the file name, if you like. To edit a field, click once 
and begin typing. Repeat the process for each document 





a : you want in the shelf. 
3. When the next dialog opens, click on the If you are not sure of the title of the PDF you want 
Extended Shelf button to create a shelf of PDF files. to add, open the PDF using the Adobe reader and make 
note of the title. 


a Ge ati be coe ee BP 





4. Select the directories that contain the PDF files you want 
to add to your shelf. 








ee tle ee 
= ‘ = = = 





February 2004 z/OS HOT TOPICS Newsletter, Issue 10 Page 37 


7. When you finish entering the [Ds and titles for all books that you want in your shelf, 
highlight the books using CTRL+SHIFT keys. When finished, click OK. 











al 
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8. When prompted to create the XKS shelf, put it in your normal shelves subdirectory. 
When done, your Shelf Organizer will look like similar to the following screen. 





Here is your new extended shelf! Now, when you need to access Redbooks, simply open the IBM 
Softcopy Reader’s Shelf Organizer and you will quickly see a list of titles instead of those cryptic file 


names. When you click on a PDF document, you will launch the Adobe reader! 


Give it a try and let us know what you think! Send your comments to mhvrcfs@us.ibm.com. 
Sa 
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Announcing the Library Center 


BY GEOFF SMITH 


Starting with z/OS V1IR5, you have an 
alternative way to navigate the z/OS 
Library on the Web. The z/OS VIR5 
Library Center provides a Microsoft 
Windows Explorer-like view of the contents 
of the entire z/OS VLR5 and Software 
Products DVD Collection. The Library 
Center uses the new IBM Library Server 
with new advanced search functions shown 
here to help you find information on 


demand as shown. 
SS=s5 


jus 2g Bay 


oe ee pees fee pe 


Oee- 6 & 
} 











A portal to 
other information 
A Redbooks” bookshelf lets 
you perform a BookManager 
search and locate a corresponding 
Redbook in PDF format. The search 
scope pull-down lets you launch 
searches in other repositories, such 
as the WebSphere Application 
Server for z/OS or an 
Internet search engine. 


























entire repository, a particular shelf, or a 
specific book. In addition, new advanced 
searches let you filter by information type. 
For example, you can search on only 
messages or only commands. his new 

function will be expanded over time 
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New advanced 
searches 

A search scope pull-down on the 

Library Center lets you search the 













to other information types, such as 
PARMLIB statements, APIs, 


and macros. 
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Getting Started 
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Easier 
navigation 
When you open the Library 
Center, you will see a left- 
hand navigation frame that lets 
you visually navigate the entire 


Expand each shelf to see all the 
books in that shelf. Expand 
each book to see all the 
topics. 









repository of over 2000 manuals. 
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A single frame mode makes 
the new Library Center more 
accessible to people using 
screen readers, such as the 


eh 
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Integration of 
BookManager with 
PDF 
The Library Center provides 
even better integration between 
BookManager and PDF file formats 
than our existing Internet Library. Ifa 
book is available in both file formats, 
you can choose which one to open 
by clicking the appropriate 
symbol in the table of 
contents. 
































February 2004 













z/OS HOT TOPICS Newsletter, Issue 10 






Single 
frame 
navigation 







IBM Homepage 
Reader. 
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Handheld 
support 
The Library 


Center also provides a 


handheld mode to support 


both connected and 
disconnected handheld 


devices. 
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Feedbach — It’s music to our ears! 


BY ADRIENNE M. BECKER 


FeedBach, feedback. No matter how we 
spell it, or how often we hear it, we love 
it. Like a beautiful sonata, your feedback 
resonates with complexity and variety, 
keeping us motivated to fine tune our 
product information deliverables. (Corny 
or not, it’s the truth.) By the way, we are 
the @server’ Information Solutions (eIS) 
group in Poughkeepsie, New York, and we 
are responsible for developing the z/OS, 
z/NM, WebSphere Application Server, and 
Linux on zSeries product information, as 
well as information tools and deliverables. 
While our main focus is on product 
information, we also apply our usability 
experience to assist with the design and 
analysis of surveys to help us understand 
customer requirements in areas other 
than product information, such as z/OS 
migration. 

One of the best ways to get customer 
feedback about a specific subject is to 
conduct a survey, and conducting surveys 
at SHARE is an especially good source 
ot feedback because we can reach a 
large cross-section of customers quickly 
and easily. At the August 2003 SHARE 
conference, many of you responded to 
surveys we administered; these surveys 
varied from requesting feedback about 
OS/390 and z/OS documentation, to 
product information delivery methods, and 
tools. This article will briefly tell you what 
happens to the feedback we receive and 
provide you with highlights from some of 
the data we collected in August. 


The feedback 
You must wonder what happens to all 
the information we collect from surveys 
administered at SHARE conferences. The 
process of sifting through the data begins 
as soon as the completed surveys return 
home. First, the raw data is analyzed, and 
the write-in comments are categorized. 
Next, our customer engagement team 
conducts cross-survey analyses to look 
for concurrent requirements and trends. 
Seeing how your preferences change over 
time helps us to focus in on problem areas, 
identify new requirements, and learn 
where our actions have been successful, as 
well as where new actions are indicated. 
During the feedback analysis process, 
it is also important for us to consider 
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who our survey respondents are. We 
review profile information gathered from 
questions that ask, for example, about your 
years of experience with z/OS, and areas 
of expertise. This information helps us to 
better understand our audience and make 
decisions appropriate for that audience, as 
it changes over time. 

Finally, the customer engagement 
team meets to discuss what we’ve learned 
and to develop and prioritize action items 
that address frequent customer requests. 
For example, we know that you have been 
asking for more and better examples in 









If you ask 


my opinion... 


the z/OS documentation. We have an 


action item for that request, which is being 
addressed in some of the z/OS VIR6 
product information and will broaden in 
scope over time. 

In some cases, we even follow up 
with a phone call to those of you who 
give us permission to contact you again. 
We do this to probe for more details on 
some of your answers to make sure we 
aren't misinterpreting them. The entire 
survey process, from development of the 
questionnaire, to analysis of the data, 
ensures that we get the feedback we need 
and effectively use the feedback we get. 


The surveys 

OS/390 and z/OS Documentation 
Survey 

The Documentation Survey is 
administered at every SHARE conference. 
Many of the questions remain the same 
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for each administration so we can keep 
track of trends; other questions are added 
depending on the area in which we 
need specific customer preferences. For 
example, the focus of the 05/390 and 
z/OS Documentation Survey conducted 
at the February 2003 SHARE conference 
was examples; the focus of the 05/390 and 
z/OS Documentation Survey conducted at 
the August 2003 SHARE conference was 
electronic delivery of product information. 
We received close to 300 responses 
to the OS/390 and z/OS Documentation 
Survey that was administered at the 
August SHARE conference. This was an 
extraordinary response rate and provided 
us with excellent information about our 
product information and deliverables. 
Below are some of the results from the 
trend questions. 


What we learned 

We learned that more than two-thirds 

of those who responded to this survey 

are system programmers with expertise 

in multiple areas, ranging from 
administration to z/OS UNIX System 
Services. Some respondents (22%) have 
expertise in customization and installation, 
but, generally, all of our respondents 
have expertise across all areas of system 
management. This is most likely due to 
the many years of experience most of you 
have with MVS, 05/390, or z/OS systems, 
with 73% having more than 15 years of 
experience. 

When it comes viewing, finding, 
and printing 05/390 or z/OS product 
information, your responses indicate a 
preference to view online information 
in PDF (52%) or BookManager format 
(39%), search online information using 
PDF documents (35%), as well as 
BookManager on your workstation (31%), 
and to print PDF documents (81%—no 
surprise there.) 

Getting down to the nitty gritty of 
customer satisfaction, Figure 1 on page 
41 is a graphical display of how satisfied 
or dissatisfied you are with certain 
qualities of our product information. Using 
the rating scale of one to five, with one 
indicating you are very dissatisfied and 
five indicating you are very satisfied, you 
told us that you are most satisfied with 
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Figure 1 - Satisfaction with product information qualities 


the accuracy and completeness of our 
product information and least satisfied 
with the cross-book linking and cross- 
book searching capabilities of our product 
information. 

We have been aware of the problems 
with cross-book linking and cross-book 
searching and are making improvements 
that you will begin to see in the z/OS 
V1R6 product information. Rather than 
having a cross-book link take you to the 
table of contents in a referenced document, 
beginning with the z/OS V1R6 product 
information, you will be taken directly to 
the topic of interest. We are also focusing 
on providing you with more examples and 
animations to help clarify some of complex 
information you work with. You should 
begin seeing more and better examples 
in some of the z/OS V1R6 product 
information, with more coming in later 
releases. 

Figure 2 is a graphical display of how 


satisfied or dissatisfied you are with our 


Collection kits\- 
Internet library 


information deliverables. As you can see, 
your responses to this set of questions 
indicates a high level of satisfaction with 
our CD/DVD collections and PDFs, 

and lower levels of satisfaction with the 
Softcopy Librarian, BookServer and 
READ/MVS. 

Our Poughkeepsie Softcopy Center 
Team is in the process of analyzing these 
results, along with results from the annual 
Softcopy Survey to determine what actions 
need to be taken to increase satisfaction 
with these tools. We also found that quite a 
few of you aren't familiar with our 05/390 
and z/OS wizards, or LookAt, our online 
message retrieval tool. 


To learn more about our wizards, visit: 


www jilbm.comzseries/zos/wizardsh 


Information about LookAt can be found at: 


www jibm.com/zseries/zos/bkserv/lookat 
and on your CD/DVD collections. 
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Figure 2 - Satisfaction with product information deliverables 
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IBM Health Checker Survey 

IBM Health Checker for z/OS and Sysplex 
is a tool that checks current, active z/OS 
and sysplex settings and definitions for 
an image. It compares their values to 
those either suggested by IBM or defined 
by you, as your criteria. The objective 

of IBM Health Checker is to identify 
potential problems before they impact 
your availability, or in worst cases, cause 
outages. The second version of IBM Health 
Checker became available just prior to the 
August SHARE conference and we thought 
it would be useful to check the health of 
this tool, so a survey was administered 

at the IBM Health Checker sessions. 

As of October 2003, we made Version 3 


available. 


What we learned 

We received thirty-nine responses to this 
survey. Most of the respondents are system 
programmers (85%) with almost 70% 
having more than 15 years of experience 
with MVS, OS/390, or z/OS. 

Survey respondents most requested 
checks for storage thresholds, virtual and 
real storage. And, here’s some good news: 
with Version 3 of the IBM Health Checker, 
which became available last October, we 
provide storage checks and maps, showing 
changes between IPLs. Learn more about 
Version 3 in “Prescription for Success” on 
page 10. How’s that for a fast response to 
customer feedback? 

JES tops the list of products that have 
the most potential for checks, with 8 votes. 
For a specific JES check, you requested a 
JES2 parmlib syntax checker. Yet, more 
than one person asked that “as many 
products as possible” create health checks. 
Most people will use more than one of the 
reporting methods available. More than 
half intend to use the Exception-only 
report; automated alerts and the message 
explanations are close seconds. 

Those of you who have used IBM 
Health Checker were satisfied or very 
satisfied with its ease of use, user’s 
guide, message explanations, install, 
and setup. We talked with one person 
who downloaded the tool in 15 minutes 
during a break from the SHARE technical 
sessions! 

For more information about IBM 
Health Checker, visit: 
www jibm.comyzseries/Zos/downloads/ 
Index.html#health_checker} 
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Migration 

Those of you who were running z/OS 
V1R4 or were in the process of installing 
z/OS V1R4 in the third quarter time 
frame were asked to take a survey to 
provide feedback on your migration 
experience, as well as some information 
about your system environment. 


What we learned 

z/OS V1R4 was a critical release for 
many reasons. Our migration surveys 
helped us better understand the migration 
inhibitors and motivators, and the 
effectiveness of actions taken to support 
migration to z/OS. For example, we were 
able to see how you felt about the new 
z/OS Migration book. Was it effective? 
Kighty-eight percent of you thought it was 
either helpful or very helpful. In addition, 
80% of respondents indicated they were 
very satisfied or satisfied with their 
migration experience, 16.4% were neither 
satisfied nor dissatisfied, and 3.6% were 
dissatisfied. This data has been key in 
helping us identify additional focus areas 
for migration. 


Finale 

Next time you are at a SHARE conference, 
check out the survey table. You will notice 
that we are not asking you to take as 
many surveys as we have in the past, and 
that should be music to your ears! We 
take your feedback seriously and use it to 
help ensure that we are delivering quality 
product information and information 
deliverables. Continue to let us know what 
we are doing right, and what we need to be 


improve, via surveys, phone conversations, 
online 
lwebgs.html), and face-to-face contact with 
our representatives. 

Thank you for all the feedback you 
have provided in the past, and we look 


forward to hearing from you in the future. 
| 
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BY BLAKE BAUMAN AND JACK YUAN 


DB2 phone home: ree is on the line 






A new DB2 stored procedure, DSNAIMS, 
allows you to submit IMS transactions or 
commands to IMS subsystems from DB2. 

This stored procedure invokes the z/OS user 

SVC 146 to connect to IMS and deliver IMS 
transactions or commands. IMS Transaction 
Manager is the IMS component that receives 
these DB2 requests. Once the IMS output is 
ready, it is sent back to the DB2 stored procedure 
DSNAIMS for use by the DB2 application. See the 
figure below. 


DSNAIMS uses SVC 146 
SVC 146 provides a high-level interface between IMS/TM 
and other z/OS subsystems or applications. This high- 
level interface consists of API calls to provide the following 
functions: 

¢ Connect to IMS/TM 

¢ Allocate communication sessions 

¢ Submit IMS transactions or commands 

* Receive output from IMS 

¢ Obtain unsolicited IMS transaction output 

¢ Free the communication sessions 

¢ Exit the IMS connection. 


DSNAIMS prerequisites 

Before you install and execute the DB2 DSNAIMS stored procedure, check that you have 

the following prerequisites: 

¢  DB2 Version 7 or later is running with RRSAF enabled and PTF UQ665553. 

* DSNAIMS is running in a WLM-managed stored procedure address space. 

* DSNAIMS is authorized. A DB2-supplied sample job can be used to issue the 
CREATE PROCEDURE statement for DSNAIMS and grant the execution authority for the 
procedure to PUBLIC. 

¢ IMS Version 7 or later is running with TM/OTMA activated. 

- SVC 146 is properly initialized by adding an entry to the z/OS program properties 
table (PPT) for the IMS-supplied prsysvzo initialization program. 














DB2 
application / 





A DB2 application calls the DSNAIMS stored procedure to acquire IMS data 
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Sample invocations 


Example |: Issuing an IMS /STA PGM ALL command with sample parameters. 


CALL SYSPROC.DSNAIMS(“SENDRECV”, “N”, “IMS7GRP”, “IMS7TMEM”, 
uM IMS CLNM” P NJ P NJ P N/T ‘ NJ P NJ ; 
“/STA PGM ALL.”, ims data out, “", *", **, 


user out, error message, rc) 


Example 2: Submitting an IMS IVTNO transaction to receive the result with sample 
parameters. 


CALL SYSPROC.DSNAIMS (“SENDRECV”, “N”, “IMS7GRP”, “IMS7TMEM” , 
u IMS CLNM nN ; Ass ; ALE P Ls P MI P NI ‘ 
*®IVINO DISPLAY LAST1 “, ams deta. out, 


: St, “" USer OU, Srror Message, 1c) 


Example 3: Submitting a send-only request to IMS for transaction IVTNO with sample 
parameters. 


CALL SYSPROC.DSNAIMS (“SEND “N”, “IMS7GRP”, “IMS7TMEM”, 
a\y IMSCLNM” P N77 ‘ N77 P N77 P N77 ; N77 i 
“IVTNO DISPLAY LAST1 ae ims data_out, 
“DSNAPIPE’, ~", “| User Out, €rror message, rc) 


Example 4: Submitting a receive-only request to receive asynchronous transaction output 
from IMS with sample parameters. 


CALL SYSPROC.DSNAIMS (“RECEIVE”, “N”, “IMS7GRP”, “IMS7TMEM”, 
a\y IMSCLNM” P N77 ; es P NWN7 P N77 P NW7 és 
“IVTNO DISPLAY LAST1 oS, ims data_out, 
“DSNAPIPE”’, “",. “| Ser OUC, “Error message, re) 


Drive the future: It's aMazing! 


BY elS GRAPHIC DESIGN TEAM 


Drive yourself to the z/OS server without hitting any of the potential pitfalls 
(remedied in the articles that match the graphics) along the way! 





Tips for using DSNAIMS 

¢ SVC 146 communicates with IMS/TM 
using the cross coupling facility (XCF) 
interface. That is why the invocation 
parameters of each type of DSNAIMS 
call include the XCF IMS name and 
the XCF client name. You can obtain 
the XCF IMS name from the IMS 
OTMANM= startup parameter or from the 
result of the IMS /DISPLAY OTMA 
command. The caller of DSNAIMS 
must specify the XCF client name. 

¢ Every DSNAIMS invocation contains 
the entry and exit of the IMS/TM 
connection. If there are multiple 
invocations at the same time, the XCF 
client name for each invocation must 
be unique. Because IMS supports a 
maximum of 255 XCF client names, 
you must limit the number of XCF 
client names used in your program. 


Want to find out more? 

For information about how IMS supports 

SVC 146, see the OTMA callable intertace 

chapter in IMS Open Transaction Manager 

Access Guide and Reference, 5C26-9434. 
ww 


FINISH 
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Is there a Linux In your future’? 


BY J.D. ROSS 


So, you think you can save your 
organization time and money by 
consolidating some workload to Linux on 
zSeries, but you've had trouble coming 
up with the numbers to prove it to your 
management. Does this sound like a 
familiar scenario? Have you ever wondered 
where you could turn for help in figuring 
out total cost of ownership (TCO) issues for 
a Linux on zSeries solution? 

Wonder no more. You can take 
advantage of the TCOnow!” competitive 
analysis tool from ClOview Corporation. 
This third-party tool quantifies server 
consolidation advantages of specific [BM 
solutions against similar solutions from 
other vendors. Provided by an independent 
TCO tool vendor, TCOnow! offers unbiased 
objectivity, based on real customer 
installation data analyzed by I'l’ experts. 

The TCOnovw! tool will guide you 
through an interview process covering 
hundreds of data elements, including: 
¢ Hardware 
¢ Software 
¢ Services 
* Networking 





¢ Maintenance 
° Staff 


¢ Facilities. 


You can start with the defaults that the tool 
provides for you, and then customize the 
factors that are the most critical to your 
installation. 


Some tips on cost factors 

Before you embark on your adventure with 
the TCOnow! tool, there are a few things 
to keep in mind when looking at cost 
factors. Most cost factors can be broken 
down into two categories, quantifiable 
cost factors and hidden cost factors. The 
quantifiable cost factors will probably be 
the first ones that come to mind when 
evaluating cost issues. However, the hidden 
cost factors are just as important, and can 
easily be overlooked and overshadowed by 
the other, more obvious costs. 
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When inputting your numbers into the 
tool, remember that your outcome is only 
as good as the numbers that you feed in. 
As the old saying goes, garbage in, garbage 
out. If you feed the tool poorly quantified 
numbers, you'll get a poorly quantified 
answer. 


Quantifiable cost factors 

Quantifiable cost factors can include the 

following: 

* Hardware, such as CPU, storage, disks, 
cables, and backup or standby servers. 

* Software, such as the operating 
system, middleware, system 
management programs, application 
software, and maintenance and 
support. 

* Occupancy, including physical space 
and utilities. 

- Staffing, including operators, 
system administrators, and data 
administrators. 

¢ Services, such as contract costs and 
consultants. 

* Opportunity factors, including the 
cost of money, and the costs of not 
pursuing other opportunities. 


Hidden cost factors 
Hidden cost factors can include the 
following: 

* Availability: Software outages, 
back-up and restore, service, 
debugging, and repair. 

¢ Hardware: Reliability of 
the platform, its flexibility, 
and freedom of vendor 
choice. 

¢ Opportunity: 


Time-to-market. 


Accessing the tool 
To sign up for the TCOnow! 


tool, visit: 





Here, you'll be able to read 
more about how the TCOnow! 
tool works, and view screen 
shots and sample reports 
generated from the tool. 
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When filling out the form to request access 
to the tool, there are two zSeries options 
currently available for you, IBM @server 
zseries Linux Server Consolidation 
compared to competitive UNIX and 

Intel offerings, and IBM @server zSeries 
WebSphere Application Server on z/OS 
compared to competitive UNIX offerings. 
You are free to pick either one, or both, as 
you see fit. 

The TCOnow! tool should not be 
your only source of cost estimation, but 
serves as a good starting point to give 
you a “back of the envelope” calculation 
to explore your options further. And, as 
always, before implementing any solution, 
you should have a full grasp of all of the 
financial consequences involved. [BM 
will work with you to conduct a solution 
assurance analysis, and/or a more detailed 
verification of the TCO statements you 
receive from the tool. 


Reading list 

For more information about server 
consolidation issues, visit the IBM 
Redbooks and Whitepapers sections on the 
Library page of the zSeries Linux Web site: 


www jibm.com/zseries/os/linux/libraryl 









Linux, TestDrive one today! 


BY J.D. ROSS 


Are you interested in getting your hands 
on a zSeries Linux image, but haven't had 
a chance to implement one on your own 
system? Or, do you have a Linux image up 
and running, but want to evaluate some 
IBM middleware to complete a solution? 
IBM has a few resources that might be just 
what you're looking for. 





The Linux Community Development 
System (LCDS) was launched over two 
years ago as a way of providing customers 
and developers with access to a mainframe 
Linux environment for the purpose 

of developing, porting, or testing their 
products or applications on the platform. 


Sign up for free access at: 
www jilbm.com/zseries/os/linux/Icdg. 


The Linux TestDrive offering is available 
to lindependent software vendors (ISVs), 
and provides them with no-charge limited 
access to a mainframe Linux environment. 
Fee-based programs are also available 

for those who are interested in long term 
engagements and resources outside the 
scope of the no-charge option. 






For more information, and to register 


for the TestDrive, visit: Www jibm.com/ 
Servers/enable/site/testdrive/zseriesi. 





The following software is available for 

customers, ISVs, and IBM Business 

Partners who are evaluating or including 

IBM middleware in Linux on zSeries 

solutions: 

¢ IBM DB2 8.1 Enterprise Server 
Edition for Linux on 8/390 and 
z9eries 

¢ IBM Developer Kit for Linux, Java 2 
technology edition: IBM 31-bit SDK 
and Runtime for Linux on zSeries 

¢ IBM WebSphere Application Server 
Advanced Single Server Edition V4.0 
for Linux on zSeries trial 

- IBM WebSphere MQ V5R3 for Linux 
on zSeries trial 

¢ IBM Directory Server VOR1I for Linux 


on zSeries trial. 













Download information, terms and 
conditions, and links to documentation are 






available at: 


www jilbm.com/developerworks/offers 


inux-Ssoeed-start/download-z.html. 
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ee 
Picture this! RMF Spreadsheet Reporter 


BY MATTHIAS GUBITZ 


Wouldnt it be great to exploit 
the graphics capabilities of 
workstations for doing z/OS 
performance analysis? We 
think so, too! That’s why 
we created the IBM RMF" 
Spreadsheet Reporter. While 
RMF’s SMF data provides a 
foundation for doing z/OS 
performance and capacity 
planning, RMF Spreadsheet 
Reporter allows you to access 
this valuable data from a 
workstation spreadsheet 
application. With the results, 
you can display, evaluate and 
present all types of statistical 
data for your z/OS system. 
RMF Spreadsheet Reporter serves 
as a front-end to the RMF postprocessor 
on your z/OS system. With its graphics 
capabilities, RMF Spreadsheet Reporter 
allows you to analyze z/OS performance 
data through powerful graphical charts— 


right from your workstation. 


The new interface: resource 
oriented 
Version 5, which ships with z/OS 
V1R5 RMF, is a major revision of RMF 
Spreadsheet Reporter, which was originally 
introduced in 1997. In Version 5, the task 
flow of the previous versions is replaced by 
a much more intuitive resource-oriented 
interface. As part of the new design, RMF 
Spreadsheet Reporter nowuses a split-pane 
format and is replaced by a much more 
intuitive resource-oriented interface. (See 
the figure.) The left side provides direct 
access to the resources. The right side 
provides the data view from which you can 
start the spreadsheets. 

With the new version, you can create 
graphical charts from raw SMF data in a 
single step. 


Just give it a try to see how easy it is to: 

1. Submit RMF postprocessor batch jobs 

2. Convert and load the output into your 
spreadsheet application 

3. Analyze the data with the powerful 


Macros. 
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Navigation pane 
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Start spreadsheets directly 
from the view pane 
) A ee ge ee er 

A aie pe 

Boalt — eer 

es a ee 

Bie ae ee 

qe oe 


" 
Kz Tae 
= x J 
I 
a | 







: es 7 — ae : - al a 
a es | ee a Se Se ee ee ee ee. | 






ee oe Smee emery eng ha cate Peet fee Tom 


as 


Getting started 
RMF Spreadsheet Reporter comes free 
with the RMF product offering. You can 
download the installable image from the 
host data set, SYS1.SERBPWSV (ERB9R2SW). 
The most recent version of the installable 
image is also available on the RMF Web 
page: lvww fibm.com]zseries/zos/rmf} 
After downloading the image to 
your workstation, simply double-click the 
executable file to start the installation 
process. ‘he comprehensive online help 
includes a tutorial to help you become 
familiar with the new features and get the 


most out of this tool. 
Pe 
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